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CHAPTER 1 
Introduction 



1.1 INTRODUCTION TO MCS BASIC-52 

Welcome to MCS® BASIC-52. This program functions as a BASIC interpreter occupying 8K of ROM in 
INTEL'S 8052AH microcontroller. MCS BASIC-52 provides most of the features of "standard" BASICS, 
plus many additional features that apply to control en\fiioniwiit* wd to the arcfii^tuif of tbst 8052AH. 

The design goal of MCS BASIC-52 was to develop a software program that would make it easy for a 

hardware/software designer to interact with the 8052 device; but, at the same time not limit the designer 
to the slow and sometimes awkward constructs of BASIC. This program is not a "toy" like many of the 
so called TINY BASICS. It is a powerful software tool that can significantly reduce the design time of 
many projects. MCS BASIC-52 is ideal for so called imbedded systems, whert t«acioina|s ^ not attach^ 
to system, but the system controls and manipulates equipment and data. 

MCS BASIC-52 offers many unique hardware and software features, including the ability to store and 
execute the user program out of an EPROM, the ability to process interrupts within the constructs of a 
BASIC program, plus an accurate real time clock. In addition, the arithmetic routines and I/O routines 
contained in MCS BASIC-52 can be accessed with assembly language CALL routines. This feature can 
be used to eliminate the need for the user to write these sometimes difficult and tedious programs. 

All of the above are covered in this document. This is NOT a "How to Write Basic Programs" manual. 
Many excellent texts on this subject have been produced. Your local computer store can recommend many 
such texts. 

The descriptions of many of the statements in this manual involve rather detailed discussions that relate 
to interfacing MCS BASIC-52 to assembly language programs. If the user is not interested in using assembly 
language with MCS BASIC-52 these discussions may be ignored. If you are only interested in programming 
the MCS BASIC-52 device in BASIC, you can treat all statements the same way they would be in any 
standard BASIC interpreter. 

In reading this manual, you will find that some information may be repeated two or three times. This is 

not an accident. Years of experience have proven that one of the most frustrating experiences one encounters 
with manuals is trying to find a particular piece of information that the reader knows is in the manual, but 
can't remember where. 
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1.2 GETTING STARTED 

If you are like most engineers, technicians, hobbyists and humans, and don't like to read manuals, this 
section is for you. The purpose of this section is to get yoil off on the right foot. If you are in the High 
Anxiety Mode and just want to see if the dam chip works, wire the device in the minimum hardware 
configuration as suggested in the Hardware Configuration chapter of this manual, apply power, and watch 
what happens. NOTHING! That's because after power is applied to the MCS BASIC-52 device, the 
program initializes the 8052 AH hardware and goes into an AUTO-BAUD search routine. You must touch 
the space bar on the serial input device in order to get MCS BASIC-52 to SIGN ON. The message that 
will appear is *MCS-51 BASIC Vx.x*. If a space character is not the first character sent to the MCS 
BASIC-51 device after reset, you can spend a lot of time trying to figure out what went wrong. So do 
yourself a favor, read this section and touch the space bar before you call your local Intel Field Applications 
Engineer. We received a number of questions asking how the AUTO-BAUD search routine worked. As 
a result this routine is listed in Chi^ter 1 1 of this manual. 



1.3 WHAT HAPPENS AFTER RESET? 

After RESET, MCS BASIC-52: 

1) Clears the INTERNAL 8052AH memory 

2) Initializes the internal registers and pointers 

3) Tests, clears, and sizes the EXTERNAL memory 

BASIC then assigns the top of EXTERNAL RANDOM ACCESS MEMORY to the SYSTEM CONTROL 
VALUE — MTOP and uses this number as the random number seed. BASIC assigns the default crystal 
value, 1 1 .0592 Mhz, to the SYSTEM CONTROL VALUE — XTAL and uses this default value to calculate 
all time dependent functions, such as the EPROM programming timer and the interrupt driven REAL TIME 
CLOCK. Finally, BASIC checks external memory location 8000H to see if the baud rate information is 
stored. If the baud rate is stored, MCS BASIC-52 initializes the baud rate generator (the 8052AH's SPECIAL 
FUNCTION REGISTER — T2C0N) with this information and signs on. If it isn't stored, BASIC inter- 
rogates the serial port input and waits for a space character to be typed. This sounds like a lot, but on the 
8052AH, it doesn't take much time. 
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1.3 \¥HAT HAPPENS Ai=TER RESET? 

MCS BASlC-52 initializes the 8052AH's Special Function Registers, TMOD, TCON, and T2CON with 
tile following values: 

TCON - 244 (0F4H) 

TMOD - 16 (lOH) 

T2CON - 52 (34H) 

After Reset, the console device should display the following: 

*MCS-51(tm) BASIC Vx.x* 
READY 

To see if everything is OK after Reset, type the following: 

>PRINT XTAL, TMOD, TC(», TMX)N 
(BASIC should respond) 
11059200 16 244 52 

If it does, everything is working properly. If it does not make sure that the external memory, the serial 
port, and the oscillator are connected and working. Hardware debug begins here. 

In the Appendix of this manual is a QUICK REFERENCE GUIDE. It provides a short description of all 
of the COMMANDS and STATEMENTS implemented in MCS BASIC-52. You might want to use this 
section to gain a quick understanding of the MCS BASIC-52 software package. Those of you who are 
famihar with the BASIC language will notice that most of flie STATEMENTS and COMMANDS used in 
MCS BASIC-52 are "standard," so getting started should not be a problem. 



1.4 DEFINITION OF TERMS: - - 

COMMANDS: 

MCS BASIC-52 operates in two modes, the COMMAND or direct mode and the interpreter or RUN mode. 
MCS BASIC-52 Commands can only be entered when the processor is in the COMMAND or direct mode. 
MCS BASIC-S2 takes immediate action after a command has been entered. This document will use die 
terms RUN MODE and COMMAND MODE to refer to the two different modes of operation. 

STATEMENTS: 

A BASIC program is comprised of statements. Every statemmt begins with a line number, followed by 
the statement body, and terminated with a Carriage Return (cr), or a colon (:) in the case of multiple 
statements per line. Some statements can be executed in the COMMAND MODE, others cannot. The 
DESCRIPTION OF STATEMENTS section of this manual describes whether a statement can be executed 
in die COMMAND mode or only in the RUN mode. 

There are three general types of statements in MCS BASIC-52: ASSIGNMENTS, INPUT/OUTPUT, and 
CONTROL. The DESCRIPTION OF STATEMENT section of Ms maml &e^ms what Qrpe is assodMed 
widi each statement. 

• EVERY line in a program must have a statement line number ranging betw^n and 65535 inclusive. 

• Statement numbers aie used by BASIC to order the program statements sequentially. 

• la any program, a statement number can be used only once. 

• Statements need not be entered in numerical coder, becauie BASIC will automatkaUy ordi» ibem in 
ascending otdea:. 

• A statement may contain no more than 72 characters in Version 1.0 and no more than 79 in Ve^m 
1.1. 

• Blanks (spaces) are ignored by BASIC and BASIC automatically inserts blanks during LIST. 

• More than one statement can be put on a line, it separated by a colon (:), but only one statement number 
is allowed per line. 

FORMAT STATEMENTS: 

Format Statements may only be used within the PRINT STATEMENT. The format statements include 
TAB([expr]), SPC([expr]), USING(special symbols), and CR (carriage return with no line feed). Details 
of the format stsOranents are provided in fee desoi^ion of the PRINT STATEMENT section of this manual. 
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1.4 DEFINITION OF TERMS r rf. 

DATA FORMAT: 

The range of numbers ^at can be r^nesented in MCS BASIC-52 is: 

± IE- 127 to ±.99999999E+127. 

There are eight digits of significance in MCS BASIC-52. Numbers are internally rounded to fit this precision. 
Numbm may be entered and displayed in four formats: integer, decimal, hexadecimal, and exponential. 
KCAMPLE: 129, 34.98, OA6EH, 1.234S6E-I-3 

INTEGERS: a' 

In MCS BASIC-52, integers are numbers that ranges from to 65535 or OFFFFH. All integers can be 
entered in either decimal or hexadecimal format and all hexadecimal numbers must begin with a valid digit 
(e.g. the number AOOOH must be entered OAOOOH). When an operator, such as .AND. requires an integer, 
MCS BASIC-52 will truncate the fraction portion of number so it will fit the integer format. All line 
numbers used by MCS BASIC-52 are integm. TMs deeom^ 'tM iM& 10 integ»8 and line JMUliiS, 
respectively in the following manner 

[integer] — Dn num] 

NOTE — Throughout this docum^t tiie brackets [] are med only to indicate an integer, constant, etc. 
They are NOT entered wh^ typing tiie acbtal number or variable. 

CONSTANTS: 

A constant is a real number that ranges from ± 1 E— 127 to ± .99999999E-I- 127. A constant, of course, 
can be an integer. Ttiis docuraeirt will refer to ccmstants in the fo^owtng manner 

[const] 

OPERATORS: 

An operator performs a pre-defined operation on variables and/or constants. Operators require either one 
or two operands. Typical two operand or dyadic operators include ADD ( + ), SUBTRACT ( — ), MUL- 
TIPLY (*), and DIVIDE (/). Operators that require only one operand are often referred to as UNARY 
CffmATmS. Smne typical UNARY OPHiATCHKS ate SIN, COS, and ABS. 
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1.4 DEFINITION OF TERMS 



t. 



VAfllABLES: 



In Version 1.0 of MCS BASIC-52 a variable could be defined as either a letter, (i.e. A, X, I), a letter 
followed by a number, (i.e. Ql, T7, L3), a letter followed by a ONE DIMENSIONED expression, (i.e. 
J(4), G(A+6), I(10*SIN(X))), or a letter followed by a number followed by a ONE DIMENSIONED 
expression (i.e. A 1(8), P7(DBY(9)), W8(A + B). In Version 1.1 variables can be defined in the same 
manner as in Version 1.0, however variables may also contain up to 8 letters or numbers including the 
undsline character. This permits the msr to use a nms desoqi^ye name £or a given variable. Ex^mfi^ 
of valid variables in Version 1 . 1 of MCS BASIC-S2. jb© m follows: 

FRED VOLTAGEl I_I1 ARRAY(ELE_1) 

When using the expanded variable names available in Vemm 1 . 1 of MCS BASIC-52 it is important to 
note that 1) It takes longer for MCS BASIC-52 to process tiiese expanded variable names and 2) The user 
may not use any keyword as part of a variable name (i.e. the variables TABLE and DIET could not be 
used because TAB and IE are reserved words). BAD SYNTAX ERRORS will be generated if the user 
attempt to ^fiae a vanable that contiuas a rested vrard. 

Variables that include a ONE DIMENSIONED expression [expr] are often referred to as DIMENSIONED 
or ARRAYED variables. Variables that only involve a letter or a letter and a number are called SCALAR 
variables. The details concerning DIMENSIONED variables are covered in the description of the STATE- 
MENT ROUTINE DIM. This document wiU refer to VARIABLES as: 



MCS BASIC-52 allocates variables in a "static" manner. That means each time a variable is used, BASIC 
allocates a portion of memory (8 bytes) specifically for that variable. This memory cannot be de-allocated 
on a variable by variable basis. That means if you execute a statement like Q = 3, later on you cannot tell 
BASIC that the variable Q no longer exists so, please "free up" the 8 bytes of memory that belong to Q. 
Sorry, it doesn't work this way. The only way the user can clear the memory that is allocated to variables 
is to execute a CLEAR STATEMENT. This Statement "ftees" all memory allocated to variables. 



IMPORTANT NOTE: 

Relative to a dimensioned variable, it takes MCS BASIC-52 a lot less time to find a scalar variable. That's 
because there is no expression to evaluate in a scalar variable. So, if you want to make a pro gram run as 



^ fast as possible, use dimensimed variables only when you have to. U^^lars for intermedi^j^ablesr. 



ibm assign the final result to a dimensioned variable. 
EXPRESSIONS: 

An expression is a logical mathematical formula that involves OPERATORS (both unary and dyadic), 
CONSTANTS, and VARIABLES. Expressions can be simple or quite complex, i.e. 12*EXP(A)/100, 

H(l)-^55, or (SIN(A)*SIN(A)-l-COS(A)*COS(A))/2. A "stand alone" variable [var] or constant [const] 
is also considered an EXPRESSION. This document will refer to EXPRESSIONS as: 



[var]. 




[expr]. 
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1.4 DiFINITtON OF TERMS 
RELATIONAL EXPRESSIONS: 

Relational expressions involve the operators EQUAL { = ), NOT EQUAL (<>), GREATER THAN (>), 
LESS THAN (<), GREATER THAN OR EQUAL TO (> and LESS THAN OR EQUAL TO (< = ). 
They are used in control statements to "test" a condition (i.e. IF A < 100 THEN . . .). Relational 
expressions ALWAYS REQUIRE TWO OPERANDS. This document will refer to RELATIONAL 
EXPRESSIONS as: 

[rel expr]. 

SPECIAL FUNCTION OPERATORS: 

Virtually all of the special function registers on the 8052AH can be accessed by using fee special function 
operators. The exceptions are PORTS 0, 2 and 3 and non-I/O associated registers such as ACC, B, and 
PSW. Other SPECIAL FUNCTION OPERATORS are XTAL and TIME. Details of the SPECIAL FUNC- 
TION Qi^RATORS Bse covesed ia fee SWOAL FUNCTION OPIRATORE. 

SYSTEM CONTROL VALUES: 

The system control values include the following: LEN (which returns the length of the program), FREE 
(which designates how many bytes of RAM are not used that are allocated to BASIC), and MTOP (which 
is the last memory location that is assigned to BASIC). D^ls of spitwi conW ^wps a*e coveMl 
in the section SYSTEM CONTROL VALUES. 
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1.4 DEFINITION OF TERMS 

STACK STRUCTURE: 

MCS BASIC-52 reserves the first 512 bytes of EXTERNAL DATA MEMORY to implement two "soft- 
ware" stacks. These are the control stack and the arithmetic stack or ARGUMENT STACK. Understanding 
how stacks work in MCS BASIC-52 is NOT NECESSARY if the user wishes only to program in 
BASIC. However, understanding the stack structure is necessary if the user wishes to link MCS BASIC-52 
to ASSEMBLY language routines. The details of how to link to assembly language are covered in the 
ASSEMBLY LANGUAGE LINKAGE section of this manual. 

CONTROL STACK — The control stack occupies locations 96 (60H) through 254 (OFEH) in external 
ram memory. This memory is used to store all information associated widi loop control (i.e. DO^ — WHILE, 
DO — UNTIL, and FOR — NEXT) and basic subroutines (GOSUB). The stack is initialized to 254 

(OFEH) and "grows down." 

ARGUMENT STACK — The ARGUMENT STACK occupies locations 301 (12DH) through 510 (IFEH) 
in external ram memory. This stack stores all constants that MCS BASIC-52 is currently using. Operations 
such as ADD, SUBTRACT, MULTIPLY, and DIVIDE always operate on the first two numbers on the 
ARGUMENT STACK and return the result to the ARGUMENT STACK. The argument stack is initialized 
to 510 (IFEH) and "grows down" as more values are placed on the ARGUMENT STACK. Each floating 
point number placed on the ARGUMENT STACK requires 6 BYTES of storage. 

INTERNAL STACK — The stack pointer on the 8052AH (SPECIAL FUNCTION REGISTER, SP) is 
initialized to 77 (4DH). The 8052AH's stack pointer "grows up" as values are placed on the stack. In 
MCS BASIC-52 the user has the option of placing the 8052AH's STACK POINTER anywhere (above 
location 77) in internal memory. The details of how to do this are covered in the ASSEMBLY LANGUAGE 
LINKAGE sectioai of this manual. 

LINE EDITOR: 

MCS BASIC-52 contains a minimum level line editor. Once a line is entered the user may not change the 
line without re-typing the line. However, it is possible to delete characters while a line is in the process 
of being entered. This is done by entering a RUBOUT or DELETE character (7FH). The RUBOUT 
character will cause the last character entered to be erased from the text input buffer. Additionally, a 
control-D will cause the entire line to be erased. In Version 1.1 of MCS BASIC-52, Control-Q (X-ON) 
and Control S (X-OFF) recognition have been added to the serial port. The user is cautioned not to 
accidently type a Control-S when entering information because the MCS BASIC-52 will no longer respond 
to the console device. Control-Q is used to bring the console device back to life afta Control-S is typed. 

NOTE — In this document a carriage return is indicated by the symbol (cr). The carriage return is the 
RETURN key on most keyboards. 
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1 .5 miATS THE DiFFifl@4€i BETWgEN V$ J Jll» V1 .1 

Thanks to feedback from many of the users of MCS BASIC-52, a number of changes and additions have 
been made to Version 1.1. All of these changes and additions were made to enhance the usefulness of the 
product and yet retain 100% compatibility, well almost 100% compatibility with the original version. To 
make things simple, all of the changes will be mentioned here and a reference will be provided as to where 
tie madec of this m^ual may cMam tmm information about the diange or addition. 

The only change that has been made to VI.l that is not compatible with Vl.O is with the IF_THEN_ 
ELSE STATEMENT when used with multiple statements per line. M VI. 0, ttie foUowIng two exampli^ 
would function in Uje same mmxm, 

EXAMPLE 1: 



10 IF A=B THEN C=A 


A=A/a : 


GOTO 100 


aO PRINT A 







EXAMPLE 2: 



10 IF A=B THEN C=A 
12 A=A/2 
14 GOTO 100 

m Pnim a 



They function in the same manner because Vl.O treats the delimiter (:) exactiy the same as a carriage 
return (cr) in every case. However, VI. 1 executes the remainder of the line if and only if the test A = B 
proves to be true. This means in EXAMPLE 1 IF A did equal B, VI. 1 would then set C = A, then set 
A = A/2, then execute line 100. IF A did not equal B, VI.l would then PRINT A and ignore the statements 
C = A : A=A/2 : GOTO 100. VI.l will execute EXAMPLE 2 exactly the same way as Vl.O. This same 
logical interpretation holds true for the ELSE statement as well. This example dictates a simple rule for 
maintaining IF_THEN_ELSE compatability between the two versions. IF THE DELIMITER (:) IS NOT 
USED AN IF_THEN_ELSE STATEMENT, Vl.O AND VI.l WIIX TREAT THE STAimiENTS 
IN rm SAME MANNER! ! 

This change was made because most users of MCS BASIC-52 felt that the VI.l interpretation of tiiis 
statem^t was more useful because fewo: GOTO stalem^ts need be emjployed in a typical program. 

Additionally, VI.l accepts inputs in either lower or upper case, whereas Vl.O converted lower case to 
upper case. VI.l will however, convert keywords from lower case to upper case during the LISTing of a 
program. Finally, MCS BASIC-52 VI.l runs between 2% and 10% faster than Vl.O. Typically, this should 
not cause any proM^s. 

As far as the user is concerned, these are the only changes that may affect the operation of a typical 
program. Now, on to the additions. 
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1.5 WHAT'S THE DIFFERENCE BETWEEN VI. AND VI .1 
ADDITIONS TO MCS BASIC-52 VI .1: 

• X-ON (control Q) and X-OFF (control S) have been added. These permit the user to "stop" (control 
S) and start (control Q) the display of characters during a LIST or PRINT. This feature also permits 
synchronization with external I/O (input/output) devices. The X-OFF (control S) functions on a line by 
line basis, not on a character by character basis. 

• Five new statements have been added. These mclude IDLE, LD@, ST@, PGM, and RROM. Details 
of tiiese stateoients are listed undo: the DESCRIPTION OF STATBNffiMTS seetion of Ms tmaivA'^ 

• Six new RESET options have been provided. They permit the user to assign the top of memory (MTOP) 
during reset, and allow the user to write specific RESET programs in assembly language. Additionally, 
they provide an option where the memory WILL NOT be cleared during RESET. More information on 
the specific RESET OPTIONS is detailed in the DESCRIPTIONS OF EPROM FILE COMMANDS 
under PROGl, PROG2, FR0G3, PROG4, PROGS, sad HR0G6 COMMANDS and in Chapler 11 ^ 
this manual. 

• The Timing of the EPROM programming algorithm has been significantly relaxed between the various 
strobes required for the EPROM programming function. This relaxed timing permits the user to program 
devices such as the 8751H and the 8748/9 using the EPROM programming capabilities of the Md 
BASIC-S2 device. Details of die timtng changes are in Chapter 10 of this manual. 

• During EPROM programming, the INTO/DMA REQUEST pin of the MCS BASIC-52 device is treated 

as a ready input pin. This allows for a simple direct connection to EEPROM devices such as the 2817A. 
For normal EPROM programming, INTO must be kept high or the programming hangs up. Details 
concerning the use of E^ROMS with the MCS BASIC-S2 device are provided m Chapter 10 of this 
manual. 

• A RUN TRAP option has been provided. This option traps the MCS BASIC-52 interpreter in the program 
RUN mode and will not permit the user to exit this mpde. Details of fliis option are covered in Chapter 
8.4 of this manual. 

• A user STATEMENT/COMMAND expansion option has been provided. This permits the user to easily 
add new or custom STATEMENTS and COMMANDS to MCS BASIC-52. Details of this option are 
covered in Chapter 12 of this manual. 
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1.5 WHATS THE DIFFEflENCE BlTWilN VIJO IIND V1.1 
ADDITIONS TO MCS BASIC-52 VI .1: 

• A number of new assembly language user OP BYTES have been added. These permit the user to make 
better use of the STATEMENT/COMMAND expansion option previously described. Details of these 
new OP BYTES are presented in Cksiptef 9.6 of this tnalMal. 

• The length of the input buffer has been increased from 72 characters to 79 characters and the ERROR: 
LINE TOO LONG has been eliminated. Instead, when the cursor reaches the 79th position a bell 
character will be echoed eveiytime the user attempts to enter another character. 

• A new variation on the PRINT (including PHO. and PHI.) and LIST statements have been added. This 
new option is evoked with an @ character (EXAMPLE: PRINT@ or LIST@) and permits the user to 
write specific output drivers for these statements and commands. When the @ PRINT or LIST is evoked, 
MCS BASIC-52 CALLS external code memory location 403CH. The user must put the specific output 
driver in this location. details of this og^oa is in Description of Statements inaction g£ fliis mmM. 

• The control stack has been made more "forgiving." This means that the user can execute a GOSUB 
to a subroutine that contains a FOR-NEXT loop and return from the subroutine without completing the 
FOR-NEXT loop. Version 1.0 would yield a C-STACK ERROR under these circumstances, Vl.I yields 
no error. 

• The question mark character ? is interpreted as a PRINT statement (EXAMPLE: (PRINT 10 + 20 is the 
same as ? 10+20). The symbols P. renMtos a sta^ai!id nomtk>n for PRINT just as in Vl.O. 

• The FOR-NEXT statement can be executed in the direct mode. This lets the user write short routines 
in the DIRECT MODE to, for example, display a le&m ctf memory (EXAMP1£: FOR I = 200H to 
210H: PHO. XBY(I): NEXT I) 

• Variables can be up to 8 characters in length, however, only the first character, the last character, and 
the total number of characters are of signifance. This lets the user better describe variables that are used 
in a program. Chapter 1.4 details the limitations on the expanded variables in Version 1.1. 



1 .5 WHAT S THE DIFFEREMCE BETWEEN VI .0 MiD VI .1 
ADDITIONS TO MCS BASIC-52 VI .1: 

• The CALL statement vectors to locations 4100H through 41FFH if the CALL integer is between and 
7FH inclusive. This means that CALL will vector to location 4100H, CALL 1 to location 4102H, 
CALL 2 to location 4104H, etc. This peimits the user to easily genende assetnbly langua^ CALL taUes 
by using simple integers with the CALL statement. Anyway, CALL through CALL IFFFH was not 
too useful because these numbers vectored into the MCS BASIC-52 ROM. 

• The error message anomaly for an invalid line number on a GOTO or GOSUB STATEMENT has been 
eliminated on V 1.1 of MCS BASIC-52. The correct line number is now processed and displayed by the 
error processor. 

• The FOR-TO-{STEP}-NEXT statement can be executed in the COMMAND MODE in version l.I of 
MCS BASIC-S2. Additionally, the NEXT statemeitf does not tcqpiEg a vaiiaide version 1.1. Delilb 
of th^ fealBies are cova»d in tbe ^esmsAxm of Sts^^mi&ai^secdm ei ^m mmmL. 

• The REM statement can be executed in the COMMAND MODE. If the user is employing some t^ie 

of UPLOAD/DOWNLOAD routine with a computer, this lets the user insert REM statements, without 
line numbers in the text and not download them to the MCS BASIC-52 device. This helps to conserve 
memory. 

• Version 1.1 is also a little less "crashable" than version 1.0. This is due to a more extensive "type 
checking*' rai control trimsfBr routoes CK)TO, GOSl^). 
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CHAPTER 2 
Description of Commands 

2.1 DESCRIPTION OF COMMANDS 
COMMAND: RUN(er) 
ACTION TAKEN: 

After RUN(cr) is typed all variables are set equal to zero, all BASIC evoked interrupts are cleared and 
program execution begins with the first line number of the selected program. The RUN command and the 
GOTO statement are the only way the usct can place the MCS BASIC-52 interpreter into the RUN mode 
from the COMMAND mode. Program execution may be terminated at any time by typing a control-C on 
the console device. 

VARIATIONS: 

Unlike some Basic interpreters that allow a line number to follow the RUN command (i.e., RUN 100), 
MCS BASIC-52 does not permit such a variation on the RUN command. Execution always begins with the 
first line number. To obtain the same functionality as the RUN[ln num] command, use the GOTO[ln num] 
statement in the direct mode. SEE STATEMENT GOTO. 

EXAMPLE: 



>10 FOR I-l TQ 3 . 
>20 PRINT I 
>30 NEXT I 
>RUN 

1 
2 
3 

READY 

> 
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2.2 DESCRIPTION OF COMMANDS: 

COMMAND: CONT(cr) 
ACTION TAKEN: 

If a program is stopped by typing a control-C on the console device m by exeeutioH of a STOP stsOement, 

you can resume execution of the program by typing CONT(cr). Between tiie stopping and the re-starting 
of the program you may display the values of variables or change the values of variables. However, yon 
may NOT CONTinue if the program is modified during the STOP or aSta an error. 

VARIATIONS: 

None. 

EXAMPLE: 



>10 FOR I-l TO 10000 
>20 PRINT I 
>30 NEXT I 

>mM 




1 

2 
3 
4 

9 - (TYPE CONTROL-C OH 


RXE) 


STOP - IN LINE aO 




READY 
>PRINT I 
6 




>I-10 




>CONT 




10 
11 
IS 
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2.3 DESCRIPTION OF COMMANDS: 



COMMAND: LIST(cr) 



ACTION TAKEN: Ot 



The LIST(cr) command prints the program to the eomole device. Note that the list ccMiimand "formats^ 

the program in an easy to read manner. Spaces are inserted after the line number and before and after 
statements. This feature is designed to aid in the debugging of MCS BASIC-52 programs. The "listing" 
of a program may be tenAiiiate^at myHiae by typing a eontrol^ &a ^ consote device. b);>< ' ' 



VARIATIONS: 



Two vadaticms of the LIST COMMAND aie possible with MCS BASIC-S2. They are: 



LIST [In num] (cr) and 



LIST [hi num] — [In num] (cr) 



The first variation causes the program to be printed from the designated line number (integer) to the end 
of the program. The second variation causes the program to be printed from the first line number (integer) 
to the second line number (integer). NOTE — flic two Ime numbers MUST BE Sm>ARA1HD BY A 
DASH —. 

EXAMPLE: 



READY 
>LIST 

10 PRINT "LOOP PROORAH 
20 FOR I-l TO 3 
30 PRINT I 
40 I^XT I 
SO END 

READY 
M.IST 30 

30 PRINT I 

40 NEXT I 

30 END 

READY 

:>LIST 20-40 
20 FOR 1 = 1 TO 3 
30 PRINT I 
40 NEXT I 



ts 
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2.4 DESCRIPTION OF COMMANDS 

COMMAND: LIST#(cr) 
ACTION TAKEN: 

The LIST#(cr) command prints the program to the LIST device. The BAUD rate to this device must be 

initialized by the STATEMENT — BAUD[expr]. All comments that apply to the LIST command apply 
to the L1ST# conunand. The LIST#(cr) command is included to permit the user to make "hard copies" 
of a program. The output tD die list ^Vice is on Pl,7 oftbe MCS BA$IC'52 device. 
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2.5 DESCRiPTION OF COMMANDS 
COMMAND: LIST@(cr) (VERSION 1.1 ONLY) 
ACTION TAKEN: 

The LIST® command does the same thing as the LIST command except that the output is directed to a 
user defined output driver. This command assumes that the user has placed an assembly language output 
routine in external code memory location 403CH. To enable the @ driver routine the user must SET BIT 
27H (39D) in the internal memory of the MCS BASIC-52 device. BIT 27H (39D) is BtT 7 of internal 
memory location 24H (36D). This BIT can be set by the BASIC statement DBY(24H) = DBY(24H). 
OR.80H or by a user supplied assembly language routine. If the user evokes the @ driver routine and this 
bit is not set, the output will be directed to the console driver. The only reason this BIT must be set to 
enable the @ driver is that it adds a certain degree of protection from accidently typing LIST@ when no 
assembly language routine exist. The philosophy here is that if the user sets the bit, the user provides the 
driver or else!!! 

When MCS BASIC-52 calls the user outpat <Mver routine at location 403CH, the byte to output is in the 
accumulator and R5 of register bask (RBO). Hie user may modify the accumulator (A) and the data 
pointer (DPTR) in the assembly language output routine, but cannot modify any of the registers in RBO. 
This is intended to make it real easy for the user to implement a parallel or serial output driver without 
having to do a PUSH or a POP. 
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2.6 DESCRIPTION OF COMMANDS 

COMMAND: NEW(cr) 
ACTION TAKEN: 

When NEW(cr) is entered, MCS BASIC-52 deletes the program that is currently stored in RAM memory. 
In addition, all variables are set equal to ZERO, all strings and all BASIC evoked interrupts are cleared. 
The REAL TIME CLOCK, string allocation, and the internal stack pointer value (location 3EH) are NOT 
effected. In general, NEW (cr) is used simply to erase a pro-am and all variables. 
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2.7 DESCRIPTION OF COMMANDS 

COMMAND: NULL [integer](cr) 
ACTION TAKEN: 

TTie NULL[integer] (cr) command determines how many NULL characters (OOH) MCS BASIC-52 will 
output after a carriage return. After initialization NULL = 0. The NULL command was more important 
back in the days when a "pure" mechanical printer was the most common I/O device. Most modem 
printers contain some kind of RAM buffer that virtually eliminates the need to output NULL characters 
after a carriage return. NOTE — the NULL count used by MCS BASIC-52 is stored in internal RAM 
location 21 (15H). The NULL value can be changed dynamically in a program by using a DBY(21) = [expr] 
statement. The [expr] can be any value between and 255 (OFFH) inclusive. 

VARIATIONS: 

None. 



1 I 



inter 



CHAPTER 3 
Description of EPROIM File Commands 



DESCRIPTION OF EPROM FILE COMMANDS 

One of the unique and powerful features of MCS BASIC-52 is that it has the ability to execute and SAVE 
programs in an EPROM. MCS BASIC-52 actually generates all of the timing signals needed to program 
most EPROM devices. Saving programs in EPROMS is a much more attractive and RELIABLE alternative 
relative to cassette tape, especially in control and/or noisy environments. 

The hardware needed to permit MCS BASIC-52 to program an EPROM device is minimal, typically only 
one NAND gate, three or four transistors, and a few resistors are all that is required. Details of the hardware 
requirements are in the EPROM PROGRAMMING section of this manual. 

MCS BASIC-52 can save more than one program in an EPROM. In fact, it can save as many programs 
as the size of the EPROM memory permits. The programs are stored sequentially in the EPROM and any 
program can be retrieved and executed. This sequential storing of programs is referred to as the EPROM 
FILE. The foUowing commands peimit tjie user to g^erate and manipulate the EPROM FILE. 
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3.1 DESCRIPTION OF EPROM FILE COliMANilS - ^ 

COMMANDS: RAM(cr) and ROM [integer] (cr) 

ACnON TAKEN: > 

These two commands tell the MGS BASIC-52 interpreter whether to select the current progran (the current 

program is the one that will be displayed during a LIST command and executed when RUN is typed) out 
of RAM or EPROM. The RAM address is assumed to be 512 (200H) and the EPROM address begins at 
32, 784 (8010H). 

RAM 

When RAM(cr) is entered MCS BASIC-52 selects the current program from RAM MEMORY. This is 
usually considered the "normal" mode of operation and is the mode that most users interact with the 
command interpreter. 

ROM 

When ROM [integer] (cr) is entered MCS BASIC-52 selects the current program out of EPROM memory. 
If no integer is typed after the ROM conmiand (i.e. ROM (cr)) MCS BASIC-52 defaults to ROM 1. Since 
the programs are stored sequentially in EPROM the integer following the ROM command selects which 
program the user wants to run or list. If you attempt to select a program that does not exist (i.e. you type 
in ROM 8 and only 6 programs are stored in the EPROM) the message ERROR; PROM MODE will be 
displayed. 

MCS BASIC-52 does not transfer the program from EPROM to RAM when the ROM mode is selected. 
So, you cannot EDIT a program in the ROM mode. If you attempt to edit a program in the ROM mode, 
by typing in a line number, the message ERROR: PROM MODE will be displayed. The following command 
to be described, XFER, permits one to transfer a program from EPROM to RAM for editing purposes. 

Since the ROM command does NOT transfer a program to RAM, it is possible to have different programs 
in ROM and RAM simultaneously. The user can "flip" back and forth between the two modes at any 
time. Another added benefit of NOT transferring a program to RAM is that all of the RAM memory can 
be used for variable storage if the PROGRAM is stored in EPROM. The SYSTEM CONTROL VALUES 
— MTOP and FREE always refer to RAM not BPROM. 

VARIATIONS: 

None. 
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3.2 DESCRIPTION OF EPfl^ Fll£ OOMMANPS 
COMMAND: XF£R(cr) 
ACTION TAKEN: 

Hie XFER (transfer) command transfers the current selected program in EPROM to RAM and then selecte 

the RAM mode. If XFER is typed while MCS BASIC-52 is in the RAM mode, the program stored in 
RAM is transferred back into RAM and the RAM mode is selected. The net result is that nothing happens 
except that a few milli-seconds of CPU time is used to do a wasted move. Aft^ the XPSR conBiiaii^.ii 
executed, the user may edit |he fi^ram in the same manner any RAM {wogram may be edited. 

VARIATIONS: 

None. 



MCS® BASIC-52 



3.3 DESCRIPTION OF EPIIOM 1114 O^MMAN <i k 

COMMAND: PROG(cr) 
ACTION TAKEN: 

The PROG COMMAND programs the resident EPROM with the current selected program. The current 

selected program may reside in either RAM or EPROM. This command assumes that the hardware is 
configured in the manner described in the EPROM PROGRAMMING section of this manual. 

After PROG (cr) is typed, MCS BASIC-52 displays the number in the EPROM FILE flie program will 
occupy. 

EXAMPLE: 



>LIST 

10 
20 
30 


FOR 1=1 
PRINT I 
NEXT I 


TO 


10 




READY 
>PROG 

12 










READY 

>Raii 12 










READY 

>LIST 

10 

20 

30 


FOR 1=1 
PRINT I 

mxr I 


TO 


10 




READY 

> 








J .. If! 



In this example, the program just placed in the EPROM is the 12th program stored. 
VARIATIONS: 

None. 
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3.4 DESCRIPTION OF EPROM FILE COMMANDS 
COMMANDS: PROGl(cr) and PROG2(cr) 
ACTION TAKEN: 
PROG1 

Normally, after power is applied to the MCS BASlC-52 device, the user MUST type a "space" character 
to initialize the 8052AH's serial port. As a convenience, MCS BASIC-52 contains a PROGl COMMAND. 
What this command does is program the resident EPROM with the BAUD RATE information. So, the 
next time the MCS BASIC-52 device is "powered up," i.e. RESET, the chip will read this information 
and initialize the serial port with the stored band rate. The "sign-on" message will be sent to the console 
immediately after the MCS BASIC-52 device completes its reset sequence. The "space" character no 
longer needs to be typed. Of course, if the BAUD rate on the console device is changed a new EPROM 
must be progprammed to make MCS BASIC-52 compatible witii the new console. 

PR0G2 

The PR0G2 command does everything the PROGl conunand does, but instead of "signing-on" and 
entering the COMMAND MODE, the MCS BASIC-52 device immediately begins executing the first 
program stored in the resident EPROM. | 

THIS IS AN IMPORTANT FEATURE!! 

By using the PR0G2 command it is possible to RUN a program from a RESET condition and NEVER 
connect the MCS BASIC-52 chip to a console. In essence, saving PROG2 information is equivalent to 
typing a ROM 1, RUN command sequence. This is ideal for control applications, where it is not always 
possible to have a terminal present. In addition, this feature permits the user to write a special initialization 
sequence in BASIC or ASSEMBLY LANGUAGE and generate a custom "sign-on" message for specific 
applications. 
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3 J DESCRIPTION OF EPim Ptt# C^OIIMI^mtt 

COMMANDS: FPROG(cr), FPROGl(cr), AND FPROG2(cr) 
ACTION TAKEN: 

FPROG(cr), FPROGl(cr), and FPROG2(cr) do exactly the same thing as PROG(cr), PROGl(cr), and 
PROG2(cr) respectively, except that the algorithm used to perform the programming function is the INTEL 
"INTELLIGENT" fast programming algorithm. The user MUST provide a way to iiwrease VCC to the 
^ROM to 6 volts. 
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3.6 DESCRIPTION OF EPflOM RLE COMMANDS 

COMMANDS: PROG3(cr), PROG4(cr), FPROG3(cr), FPROG4(cr) (VERSION 1.1 ONLY) 

ACTION TAKEN: 

PROGS 

The PROG3 COMMAND functions the same way as the PROGl COMMAND previously described, except 
that PROGS also saves the system control value, MTOP, when it is evoked. During a RESET or power- 
up sequence MCS BASIC-52 will only clear the external data memory up to the MTOP value that was 
saved when the PROG3 COMMAND was evoked. This permits the user to ' 'protect' ' regions of memory 
fix)m being cleared during a RESET or power-up condition. In typical use, the PROG3 COMMAND 
assumes that the user is saving some critical information if some type of battery-backed-up or non-volitle 
memory and does not want this information to be destroyed during a RESET or power-up sequence. 

PR0G4 

Hie PROG4 COMMAND is a combination of the PROGl and PR0G3 COMMAND. PR0G4 saves the 
same information as PROG3, but also execates the first program stored in the EPROM after a RESEI* or 
power-up condition. 

FPR0G3 and FPR0G4 

The FPROG3 and FPROG4 commands save the same information as the PR0G3 and PR0G4 como^i^ 
respectively, except that the INTELligent™ algorithm is used to popam the EPROM. 

VARIATIOI^: 

None. 
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3.7 DESCRIPTION OF EPROM FILE COMMANDS 

COMMANDS: PROG5(cr), PROG6(cr), FPROG5(cr), FPROG6(cr) (VERSION 1.1 ONLY) 
ACTION TAKEN: 

PROGS &FPROGS / V ^ 

The PROGS command saves both the baud rate information and the MTOP information, just like the 
PROGS command previously described. However, during a RESET or power-up condition the MCS 
BASIC-52 device examines external data memory location 5FH (95 decimal). If the user has placed the 
value 0A5H (165 decimal) in this location, the MCS BASIC-52 device will not dear the external memory 
during a RESET or power-up condition. This permits the user to "save" programs in ext«»al memxnf:, 
providing some type of battery back-up scheme has been employed. 

Normally, when using the PROGS command to establish the RESET or power-up condition, the MCS 
BASIC-52 device will enter the command mode after RESET or power-up. However, if the user wishes 
to execute the program stored in external memory, the character 34H (52 decimal) needs to be placed in 
external memory location 5EH (94 decimal). Placing a 34H in location SEH causes MCS BASIC-52 to 
enter the "RUN TRAP MODE." Details of this mode are presented in chapter 8 of this manual. 

PR0G6 & FPR0G6 

Does the same thing as PROGS, but CALLS external program memory location 4039H during a RESET 
or power-up sequence. This option also requires the user to put the character 0A3H in external memory 
location 5FH to insure that external RAM will not be cleared during RESET or power-up. The user must 
put an assembly language initiaUzaticm HHitine in external coie OKraoiy location 4039H or else this RESET 
mode will crash. When the user returns firom the costondzed assaoaibly ku^uage RESET loudne, Haee 
options exist: 

OPTION 1 FOR PR0G6 

If the CARRY BIT is CLEARED (CARRY = 0) upon return from the user RESET routine MCS BASIC-52 

will enter the auto-baud rate determining routine. The user must then type a space character (20H) on the 
terminal to complete the RESET routine and produce a RESET message on the terminal. 

OPTION 2 FOR PflOG6 

If the CARRY BIT is SET (CARRY = 1) and BIT of the ACCUMULATOR is CLEARED (ACC. 

= 0) MCS BASIC-52 will produce the standard sign-on message upon return from the user supplied 
RESET routine. The baud rate will be the one that was saved when the PROG6 option was used. 

OPTION 3 FOR PR0G6 

If the CARRY BIT is SET (CARRY = 1) and BIT of the ACCUMULATOR is SET (ACC. = 1), 
MCS BASIC-S2 will execute the first program stored by the user in EPROM (starting address of the 
program is 8010H) upon return from the user supplied RESET routine. 
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CHAPTER 4 
Description of Statements 



4.1 DESCRIPTION OF STATEMENTS 

STATEMENT: BAUD [expr] 
MODE: COMMAND AND/OR RUN 
TYPE: CONTROl. 

The BAUD [expr] statement is used to set the baud rate for the software hne printer port resident on the 
MCS BASIC-52 device. In order for this STATEMENT to properly calculate the baud rate, the crystal 
(special function operator — XTAL) must be correctly assigned (e.g. XTAL = 9(XX)000). MCS BASlC-52 
assumes a crystal value of 11.0592 MHz if no XTAL value is assigned. The software line printer port is 
PI. 7 on the 8052AH device. The main purpose of the software line printer port is to let the user make a 
"hard copy" of program listings and/or data. The COMMAND LIST# and the STATEMENT PRINT# 
direct outputs to the software line printer port. If the BAUD [expr] STATEMENT is not executed before 
a LIST# or PRINT# command/statement is entered, the output to the software line printer port will be 
at about 1 BAUD and it will take A LONG TIME to ouq)ut something. You may even think that BASIC 
has crashed, but it hasn't. It's just outputting at a VERY SLOW rate. So be sure to assign a BAUD rate 
to the software printer port BEFORE using LIST# or PRINT#. The maximum baud rate that can be 
assigned by the BAUD statement depends on the crystal. In general, 48(X) is a reasonable maximum baud 
rate, however die u^r may want to experio^nt with differa^ rates. The software serial transmits 8 data 
bits, 1 st^ Mt, aikl: two stop bits. No parity is ^RHtsmittedi. 

EXAMPLE: 

BAUD 1200 

Will eaumc th« lln* pr Inter port to output tfat* at 1200 SAUD. 



VARIATIONS: 

None. 



4.2 DESCRIPTION OF STATEMENTS 

STATEMENT: CALL [integer] 
MOOl: COMMAND AND/<m RUN 
TYPE: CONTROL 

The CALL [integer] STATEMENT is used to call an assembly language program. The integer following 
CALL is the address where the user must provide the assembly language routine. To letum to BASIC the 

user must execute an assembly language RET instruction. Examples of how to use the CALL [integ^] 
instruction are given in the ASSEMBLY LANGUAGE LINKAGE section of this manual. 

EXAMPLE: 



CALL 9000H 



Will cause the 8052AH to execute the assembly language prognon beginning at location 9000H (i.e. the 
program counter will be loaded with 90C)0H). 

VARIATIONS: (VERSION 1.1 ONLY) 

If the integer following the CALL statement is between and 127 (7FH), Version 1.1 of MCS BASIC-52 
will multiply the user integer by two, then add 41(X)H and vector to that location. This means that CALL 
will call location 4100H, CALL 1 will call 4102H, CALL 2 — 41(MH and so on. This permits the usct 
to generate a simple table of assembly language routines without havmg to enter 4 (%it hex integers afto: 
die CALL statement from the user supplied RESET routine. 
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4.3 DESCRIPTION OF STATEMENTS ^ ^ 

STATEMENT: CLEAR 

MODE: COMMAS) AND/OR RUN or >m 

TYPE: CONTROL 

The CLEAR STATEMENT sets all variables equal to and resets all BASIC evoked interrupts and stacks. 
This means that after the CLEAR statement is executed an ONEXl or 0NTIME statement must be executed 

before MCS BASIC-52 will acknowledge intetrupts. ERROR trapping via the ONERR statement will also 
not occur until an ONERR[integer] STATEMENT is executed. The CLEAR STATEMENT does not affect 
the real time clock that is enabled by the CLOCKl STATEMENT. CLEAR also does not reset the memory 
that has been allocated for STRINGS, so it is NOT necessary to enter the STRING [expr], [expr] STATE- 
MENT to re-allocate memory for strings after the CLEAR STATEMENT is executed. In general, CLEAR 
is simply used to "erase" all variables. - , 

VARIATIONS: i 

Nmie. 



4.4 DESCRIPTION OF STATEMENTS 

STATEMENTS: CLEARI (dear interrupts) 

CLEARS (dear stacks) 
MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 
CLEARI 

The CLEARI STATEMENT blears all of the BASIC evoked interrupts. Specifically, the ONTIME and 
ONEXl interrupts are DISABLED after the CLEARI STATEMENT is executed. This is accomplished by 
clearing bits 2 and 3 of the 8052AH's special function register, IE and by clearing the status bits that 
determine whether MCS BASIC-52 or the user is controlling these interrupts. The real time clock which 
is enabled by the CLOCKl STATEMEOT is not affected by CLEARI. This statement can be used to 
selectively DISABLE interrupts duriag specific sections of the users BASIC program. The ONTIME and/ 
or ONEXl STATEMENTS MUST 11 MXECatrTED AGAIN befiMe the specific interrupts vM be eoafoled. 

CLEARS 

The CLEARS statement RESETS all of MCS BASIC-52's STACKS. The CONTROL and ARGUMENT 
STACKS are reset to their initialization value, 254 (OFEH) and 510 (IFEH) respectively. The INTERNAL 
STACK (the 8052AH's STACK FODDER, SPECIAL FUNCTION REGISTER-SP) is loaded with tiie 
value that is in INTERNAL RAM location 62 (3EH). This statement can be used to "purge" the stack 
should an error occur in a subroutine. In addition, this statement can be used to provide a "special" exit 
from a FOR-NEXT, DO-WHILE, ot DO-UNTDL loop. 

..•■I 

EXAMPLE OF CLEARS: 



>10 PRINT "MULTIPLICATION TEST. YOU HAVE S 8EC0ND8" 




>20 FOR I > 2 TO 9 




>30 N - INT(RN0*10> : A * N*I 




>40 PRINT "MHAT IS N. 1. CLOCKl 




>90 TINE - : ONTinE 9. 200 : II«>UT R: IF ROA THEN lOO 




>40 PRINT "THAT'S RIOHT": TIME-O: NEXT I 




>70 PRINT "YOU DID IT. 0000 JOB": END 




MOO PRINT "WRONO. TRY AeAIN":OaTQ 90 




>200 REM WASTE CONTROL STACK. TOO MUCH TIME 


■ .X' 


>S10 CLEARS: PRINT "YOU TOOK TOO LONe":COTO 10 





NOTE: When the CLEARS and CLEARI STATEMENTS are LISTED they wiU appear as CLEAR S 
and CLEAR I re^pedively. Don't be alarmed, that is the way it's supposed to worit. 
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4.5 DESCRIPTION OF STATEMENTS 
STATEMENTS: CLOCKl and CLOCKO 
MODE: COMMAM) AND/OR RUN 
TYPE: CONTROL 
CLOCKl 

The CLOCKl STATEMENT enables the REAL TIME CLOCK feature resident on the MCS BASIC-52 
device. The special function operator TIME is incremented once every 5 milliseconds after the CLOCKl 
STATEMENT has been executed. The CLOCKl STATEMENT uses TIMER/COUNTER in the 13-bit 
mode to generate an interrupt once every 5 milliseconds. Because of this, the special fiinctiim opasn^f 
TIME has a resolution of 5 milliseconds. 

MCS BASIC-52 automatically calculates the proper reload value for TIMER/COUNTER after the crystal 
value has been assigned (i.e. XTAL = value). If no crystal value is assigned, MCS BASIC-52 assumes a 
value of 11.0592 MHz. The special function operator TIME counts from to 65535.995 seconds. After 
reaching a count of 65535.995 seconds TIME overflows back to a count of zero. Because the CLOCKl 
STATEMENT uses the interrupts associated with TIMER/COUNTER (the CLOCKl statement sets bits 
7 and 2 in the 8052AH's special function register, IE), the user may not use this interrupt in an assembly 
language routine if the CLOCKl STATEMENT is executed in BASIC. The interrupts associated with the 
CLOCKl STATEMENT cause MCS BASIC-52 programs to run at about 99.6% of normal speed. That 
vmms that the interrupt h^dling for the REAL TIME CLOCK feature only consumes about .4% of the 
total CPU time. This very small interrupt oveiliead is atGributed to the very fast and effective interrupt 
handling of the 805 2AH device. * 

CLOCKO 

The CLOCKO (zero) STATEMENT disables or "turns off the REAL TIME CLOCK feature. This 

statement clears bit 2 in the 8052AH's special function register. IE. After CLOCKO is executed, the special 
function operator TIME will no longer increment. The CLOCKO STATEMENT also returns control of the 
interrupts associated with TIMER/COUNTER back to the user, so this interrupt may be handled at the 
assembly language level. CLOCKO is the only MCS BASIC-52 statement that can disable the REAL TIME 
CLOCK. CLEAR and CLEARI wUl NOT disable the REAL TIME CLOCK. ' 

VARIATIONS: 

None. 



m 



MCS« BASIC-52 



4.6 DESCRIPTION OF STATEMENTS 



STATEMENTS: DATA — READ — RESTORE 



MODE: RUN 



TYPE: ASSIGNM04T 



DATA 



DATA specifies expressions that may be retrieved by a READ STATEMENT. If multiple expressioas^^ 
line are used, they MUST be separated by a comma. 

READ 

READ retrieves the expressions that are specified in the DATA STATEMENT and assigns the value of 
the expression to the variable in the READ STATEMENT. The READ STATEMENT MUST ALWAYS 
be followed by one or more variables. If more than one variable follows a READ STATEMENT, they 
MUST be sep^ted by a comma. 

RESTORE 



RESTORE "resets" the internal read pointer back to the beginning of the data so that it may be read 
again. 

EXAMPLE: 



MO FOR I-l TO 3 

:>20 READ A, B 

;>30 PRINT 'A, B . 

;>40 NEXT I 

:'50 RESTORE 

;>60 READ A. B 

>70 PRINT A, B 

:>80 DATA 10. 20, 10/2. 20/2. SIN(PI ) . CQS(PI ) 
>RUN 

10 20 
5 10 
-1 
10 20 



VARIATIONS: 



None. 
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4.6 DESCRIPTION OF STATEMENTS 

Explanation of previous example: 

Everytime a READ STATEMENT is encountered the next consecutive expression in the DATA STATE- 
MENT is evaluated and assigned to the variable in the READ STATEMENT. DATA STATEMENTS may 
be placed anywhere within a program, they will NOT be executed nor will they cause an error. DATA 
STATEMENTS are considered to be chained together and appear to be one BIG DATA STATEMENT. 
If at anytime all the DATA has been read and another READ STATEMENT is executed then the program 
is teiminated and the message ERROR: NO DATA — IN LINE XX is printed to the console device. 



I 
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4.7 DESCRIPTION OF STATEMENTS 
STATEMENT: DIM 
MODE: COMMAND AND/OR RUN 
TYPE: ASSIGNMENT 

DIM reserves storage for matrices. The storage area is first assumed to be zero. Matrices in MCS BASIC- 
52 may have only ONE DIMENSION and the size of the dimensioned array MAY NOT exceed 254 
elements. Once a variable is dimensioned in a program it may not be re-dimensioned. An attempt to re- 
dimension an array will cause an ARRAY SIZE ERROR. If an arrayed variable is used that has NOT been 
dimensioned by the DIM STATEMENT, BASIC will assign a default value of 10 to the array size. All 
arrays are set equal to zero when the RUN COMMAND, NEW COMMAND, or the CLEAR STATEMENT 
is executed. The number of bytes allocated for an array is 6 times the (array size plus 1). So, the array 
A(IOO) would require 606 bytes of storage. Memory size usually limits the size of a dimensioned array. 

VARIATIONS: 

More than one variable can be <}ifflensioned by a single DIM STATEMENT, i.e., DIM A(10), B{15), 
Al(20). 



EXAMPLE: 



DEFAULT ERROR ON ATTEMPT TO RE-DIMENSION ARRAY 



MO A(5) = 10 
;>20 DIM A<5) 
>RUN 



- BASIC ASSIGNS DEFAULT OF 10 TO ARRAY SIZE HERE 

- ARRAY CANNOT BE RE-DIMENSIONED 



ERROR: ARRAY SIZE - IN LINE 20 



20 



DIM A(9) 
X 
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4.8 DESCRIPTION OF STATEMENTS 
STATEMENTS: DO — UNTIL [rel expr] 
MODE: RUN 

TYPE: CONTROL 

The DO — UNTIL [rel expr] instruction provides a means of "loop control" within an MCS BASIC-52 
program. All statements between the DO and the UNTIL [rel expr] will be executed until the relational 
expression following the UNTIL statenirat is TRUE. DO — UNTIL loops may be nested. 

EXAMPLES: 



SIMPLE DO-UNTIL NESTED DO-UNTIL 

MO A=0 MO DQ : A=A+1 : DO : B"B+l 

:>20 DO >20 PRINT A, B, A*B 

>30 A=A+1 ■urs.i ^-^^ UNTIL 0=3 

>40 PRINT A laiAl -,40 b=0 

:>50 UNTIL A»4 >S0 UNTIL A«3 

>60 PRINT "DONE" >RUN 



>RUN 



1 
2 
3 
4 



1 
1 
2 
2 
2 
3 
3 
3 



2 
3 



2 

3 



2 
3 
2 
4 
6 
3 
6 
9 



DONE 



READY 
> 



2 
3 



READY 

> 



VARIATIONS: 



None 
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4.9 DESCRIPTION OF STATEMENTS 

STATEMENTS: DO — WHILE [rel expr] 
MODE: RUN 
TYPE: CONraOL 

The DO — WHILE [rel expr] instruction provides a means of "loop control" within an MCS BASIC-52 
program. This operation of this statement is similar to the DO — UNTIL [rel expr] except that all statements 
between the DO and the WHILE [rel expr] will be executed as long as the relational expression following 
the WHILE statement is true. DO — WHILE and DO — UNTIL stotemeote can be nested. 

EXAMPLES: 



SIMPLE DO-WHIUE 


NESTED 


DO-WHILE - DO-WNTIL 


>10 DO 


>10 DC 


: A-A+1 : B^B^t 


>20 A-A+1 


>20 PRINT 


Ai B. A*B 


>30 PRINT A 


>30 MHILE 


B03 


:>40 MHILE A<4 


>40 B- 







>50 PRINT "DONE" 


>S0 UNTIL 


A-3 


>RUN 


>RUN 






1 


1 1 


1 




2 


1 2 


2 




3 


1 3 


3 




4 


2 1 


2 




DONE 


2 2 


4 






2 3 


6 




READY 


3 1 


3 




> 


3 2 


6 






3 3 


9 






READY 








> 







VARIATIONS: 



None 
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4.10 DESCRIPTION OF STATEMENTS ^ 

STATEMENT: END 
MODE: RUN 
TYPE: CONTROL 

TTie END STATEMENT terminates program execution. The continue command, CONT will not operate 
if the END STATEMENT is used to terminate execution (i.e., a CAN'T CONTINUE ERROR will be 
printed to the console). The last statement in an MCS BASIC-52 program will automatically terminate 
program execution if no END STATEMENT is used. 

EXAMPLES: 



r 

LAST STATEMENT 


TERniNATIQN 


END StAfewadT TERMINATION 


MO FOR 1 = 1 TO 


4 


MO FOR 1 = 1 TO 4 


>20 PRINT I 




:>20 GOSUB 100 


:'30 NEXT I 




>30 NEXT I 


>RUN 




>40 END 






MOO PRINT I 


1 




MIO RETURN 


c 




>RUN 


3 






4 




1 






2 


READY 




3 


> 




4 






READY 






> 



VARIATIONS: 

None 
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4.11 DESCRIPTION OF STATEMENTS n n 

STATEMENTS: FOR — TO — {STEP} — NEXT 

MODE: RUN VERSION 1.0 (COMMAND AND/QR RIM ia ^^r^n 1,1) 

TYPE: CONTROL 

The FOR — TO — {STEP} — NEXT STATEMENTS are used to set up and control loops. 
EXAMPLE: 



10 FOR A=B TO C STEP D 
20 PRINT A 
30 NEXT A 



If B = 0, C = 10, and D = 2, the PRINT STATEMENT at line 20 will be executed 6 times. TTie values of 

"A" that will be printed are 0, 2, 4, 6. 8, 10. "A" represents the name of the index or loop counter. 
The value of "B" is the starting value of the index, the value of "C" is the limit value of the index, and 
flie value of "D" is the increment to the index. If the STEP STATEMENT and the value "D" are omitted, 
the increment value defaults to 1, therefore, STEP is an optional statement. The NEXT STATEMENT 
causes the value of "D" to be added to the index. The index is then compared to the value of "C," the 
limit. If the index is less than or equal to the limit, control will be transferred back to the statement after 
the FOR STATEMENT. Stepping "backwards" (i.e. FOR I = 100 TO 1 STEP-1) is permitted in MCS 
BASIC-52. Unlike some BASICS, the index MAY NOT be omitted from the NEXT STATEMENT in 
MCS BASIC-S2 (i.e. the NEXT statement MUST always be followed by the appropriate varial^te). 

EXAMPLES: 



>10 FOR I»l TO 4 


>10 FOR 1=0 TO 8 STEP 2 


>20 PRINT I 


>20 PRINT I 


>30 NEXT I 


>30 NEXT t 


>RUN 


>RUN 


1 





2 


2 


3 


4 


4 


6 




8 


READY 




> 


READY 




> 
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4.11 DESCRIPTION OF STATEMENTS 

In Version 1.1 of MCS BASIC-52 it is possible execute the FOR-TO-{STEP}-NEXT statement in the 
Command Mode. This makes it possible for ttie user to do things like display regions of memory by writing 
a short program like FOR I = S 12 ^ ffiO. XBYCI),: MmCt 1. 1 ffiay aibo lave &&iet ases, bat tt^f^ 
haven't been thought of. 

Also Version 1 . 1 allows the NEXT statement to be used without a variable following the statement. This 
means that programs like: 

EXAMPLE: 



10 FOR I •• 1 TO 100 
20 PRINT I 
30 hCXT 



Are permitted in Version 1 . 1 of MCS BASIC-52. The variable associated with the NEXT is always assumed 
to be the variable used in the last FOR statement. 
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4.12 DESCRIPTION OF SWEMENTS ^ ? 

STATEMENTS: GOSUB[ln num] — RETURN 
MODE: RUN 
TYPE: CONTROL 
GOSUB 

The GOSUB [In num] STATEMENT will cause MCS BASIC-52 to transfer control of the program directly 
to the line number ([In num]) following the GOSUB STATEMENT. In addition, the GOSUB STATEMENT 
saves the location of the STATEMH^IT following GOSUB on flie coBtrol stack so that a RETURN 
STATEMENT can be perfcamed to eeton coattol. 

RETURN 

This statement is used to ' 'return" control back to the STATEMENT fcdlowing the most recently executed 
GOSUB STATEMENT. The GOSUB-RETURN sequence can be "nested" meaning that a subroutine 
caUed by the GOSUB STATEMENT can call another subroutine with another GOSUB STATEMENT. 

EXAMPLIS: 



SIMPLE SUBROUTINE 


NESTED SUBROUTINES 


>10 FOR I-l TO S 


>10 FOR I-l TO 3 


>20 008UB 100 


>20 eOSUB 100 


>30 NEXT I 


>30 NEXT I 


MOO PRINT I 


>40 END 


>110 RETURN 


>100 PRINT I. 


>RUN 


>110 eOSUB 200 




>ia0 RETURN 


1 


>200 PRINT I»I 


2 


>210 RETURN 


3 


>RUN 


4 




S 


1 1 




2 4 


READY 


3 9 


> 






READY 




> 
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4.12 DESCRIPTION OF STATEMENTS 

NOTE — The Control Stack on Version 1 . 1 permits a graceful exit from incompleted control loops, given 
the following example: 

EXAMPLE: 



90 


eosuB 1000 


1000 


FOR I = 1 TD 10 


1010 


IF X = I THEN 1040 


1020 


PRINT I»X 


1030 


NEXT I 


1040 


RETURN 



Version 1 . 1 would permit the programmer to exit fflie subroutine even though the FOR-NEXT loop might 
not be allowed to complete if X did equal I. Version 1.0 of MCS BASIC-52 would yield a C-STACK 
error if the FOR-NEXT loop was not allowed to complete before the RETURN statement was executed. 
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4.13 DESCRIPTION OF STATEMENTS - • 

STATEMENT: GOTO [In num] 
MODE: COMMAND AND/OH mH 
TYPE: CONTROL 

Hie GOTO [In num] STATEMENT will cause BASIC to transfer control directly to the line number 
([In num]) following tiie GOTO STATEMENT. 

EXAMPLE: 



90 GOTO 100 



Will, if line 100 exists, cause execution of the program to resume at line 100. If line number 100 does 
not exist tiie message ERROR: INVALID LINE NUMBER will be printed to the console device. 

Unlike the RUN COMMAND the GOTO STATEMENT, if executed in the COMMAND MODE, does 
not CLEAR the variable storage space or interrupts. However, if the GOTO STAT^dENT is executed in 

the COMMAND MODE after a line has been edited, MCS BASIC-52 will CLEAR the variable storage 
space and all BASIC evoked interrupts. This is a necessity because the variable storage and the BASIC 
program reside in the same RAM memory. So editing a pi^ipM eaa destr^ vieaMes. 

NOTE — (Version 1.0 only) 

Because of the way MCS BASlC-52's text interpreter processes a line, when an INVALID LINE NUMBER 
ERROR occurs on the GOTO, GOSUB, ON GOTO, and ON GOSUB STATEMENTS the line AFTER 
the GOTO or GOSUB STATEMENT will be printed out in the error message. This may be confiising, 
but it was a trade-off between execution speed, code mm, and eaor handling. Error handling lost. 

EXAMPLE: 



>10 GOTO 100 
>20 PRINT X 
>RUN 

ERROR: INVALID LINE NIHIBER - IN LINE 20 
20 PRINT X 



Version 1 . 1 does not exhibit this particular anomaly. 
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4.14 DESCRIPTION OF STATEMENTS 

STATEMENTS: ON [expr] GOTO[ln num], [In num], ... [In num] 
ON [^rl GOSUB[ln nwn], [In man], . . . [te wmi] 

MODE: RUN 
TYPE: CONTROL 

The value of the cjqnession following the ON sts^ment is die numbo- in the line list that control will be 
transfened to. 

EXAMPLE: 



10 ON Q GOTO 100, 200, 300 



If Q was equal to 0, control would be transferred to line number 100. If Q was equal to 1, control would 
be transferred to line number 200. If Q was equal to 2, GOTO line 300, etc. All comments that apply to 
GOTO and GOSUB apply to the ON STATEMENT. If Q is less than ZERO a BAD ARGUMENT ERROR 
will be generated. If Q is greater than the line number list following the GOTO or GOSUB STATEMENT, 
a BAD SYNTAX ERROR will be generated. The ON STATEMENT provides "conditional branching" 
opticms widiin the oxistructe of an MCS BASIC-S2 program. 



4.15 DESCRIPTION OF STATEMINTS 

STATEMENTS: IF — THEN — ELSE 
MODE: RUN 
TYPE: CONTROL 

The IF statement sets up a conditional test. The generalized form of the IF — THEN — ELSE statement 
is as follows: 

[In num] IF [rel expr] THEN valid STATEMENT ELSE valid STATEMENT 
A specific example is as follows: 

>10 IF A-lOO THEN A-0 ELSE A-A-t-1 



Upon execution of line 10 IF A is equal to 100, THEN A would be assigned a value of 0. IF A does not 
equal 100, A would be assigned a value of A + 1 . If it is desired to transfer control tb different line numbers 
using the IF statement, the GOTO statement may be omitteA Tbs fpllovi4ng examples would yield &e 
same results: 





IF 


INTCAX 


10 


THEN 


GOTO 100 


ELSE GOTO 200 


>20 


IF 


INT<A)< 


10 


THEN 


100 ELSE 


200 



Additionally, the THEN statement can be replaced by any valid MCS BASIC-52 statement, as ^wn 
below: 



>30 


IF 


AOlO 


THEN PRINT A 


ELSE 10 


>30 


IF 


AO 10 


PRINT A ELSE 


10 



The ELSE statement may be omitted. If it is, ctmtrol will pass to the next stsrteraent. 
EXAMPLE: 



:>20 IF A=10 THEN 40 
;>30 PRINT A 



In this example, IF A equals 10 then control would be passed to line number 40. If A does not equal 10 
line number 30 would be executed. 
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4.15 DESCRIPTION OF STATEMENTS 



COMMENTS ON IF-THEN-ELSE- 



Version 1.1 is not compatible with VI. when the IF_THEN_ELSE STATEMENT is used with mtfltiple 
statements per line. In V 1.0, the following two exan^les would function in the same manner. 

EXAMPLE 1: 



10 


IF A-l THEN C>A : 


A=A/S 


COTO 100 


ao 


miNT A 







EXAMPLE 2: 



10 IF A-B THEN C-A 
12 A-A/2 
14 OOTO lOO 
ao PHINT A 



They function in the same manner because Vl.O treats the delimiter (:) exactly the same as a cacriage 
return (or) in every case. However, Vl.l executes the remainder of the line if and only if the test A=B 
proves to be true. This means in EXAMPLE 1 BF A did equal B, Vl.l would then set C = A, then set 
A = A/2, then execute line 100. IF A did not equal B, VI . 1 would then PRINT A and ignore the statements 
C = A : A = A/2 : GOTO 100. Vl.l will execute EXAMPLE 2 exactly the same way as Vl.O. This same 
logical interpretation holds true for the ELSE statement as well. This example dictates a simple rule for 
maintaining 1F_THEN_ELSE compatibility between the two versions. IF THE DELIMITER (:) IS NOT 
USED IN AN IF_THEN_ELSE STATEMENT, Vl.O AND Vl.l WILL TREAT THE STATEMENTS 
IN THE SAME MANNER!! 



This change was made because most users of MCS BASIC-52 felt that the Vl.l interpretation of this 
s^tatement was more meM because few& GOTO statements need be epqployfed in a typical program. 
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4.16 DESCRIPTION OF STATEMENTS -J 

STATEMENTS: INPUT 

MODE: RUN 

TYPE: INPUT/OUTPUT 

The INPUT statement allows users to enter data from the console during program execution. One or more 
variables may be assipied data with a single input statement. The variables must be separated by a comma. 

EXAMPLE: 



I^M»UT A. B 



Would cause the printing of a question mark (?) on the console device as a prompt to the operator to input 
two numbers separated by a comma. If the operator does not enter enough data, then MCS BASIC-52 
responds by outputting the message TRY AGAIN to the console device. 

EXAMPLE: 



>10 INPUT 


A. B 


>aO PRINT 


A. B 


>RUN 




?1 




TRY AOAIN 




?1. 2 




1 2 




READY 





The INPUT statement may be written so that a descriptive prompt is printed to tell the user what to type. 

The message to be printed is placed in quotes after the INPUT statement. If a comma appears before the 
first variable on the input list, the question mark prompt character will not be displayed. 

EXAMPLES: 



>10 INPUT "ENTER A NUMBER "A 


MO INPUT "ENTER A NUMBER-". A 


;>20 PRINT SQR(A) 


>aO PRINT SQR(A) 


>RUN 


>RUN 


ENTER A NUMBER 


ENTER A NUMBER- 100 


?100 


10 


10 
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4.16 DESCRIPTION OF STATEMENTS 

Strings can also be assigned with an INPUT statement. Strings are always terminated with a carriage return 
(cr). So, if more than one string input is requested with a smgle INPUT statemrat, MCS BASIC-S2 will 
^mpt the us^ with a question mark. 

EXAMPLES: 



MO STRING 110, 10 


>10 STRING 110. 10 


>20 INPUT "NAME: ",»<1> 


>20 INPUT "NAMES: ",«(1),«<2) 


>30 PRINT "HI ", »( I ) 


>30 PRINT "HI ",»<1)," AND »<2> 


>RUN 


>RUN 


NAME. SUSAN 


NAMES: BILL 


HI SUSAN 


?ANN 




HI BILL AND ANN 


READY 






READY 



Additionally, strings and variables can be assigned with a single INPUT statement. 



EXAMPLE: 



>10 STRING 100. 10 

>20 INPUT"NAME<CR), AGE - ",»(1),A 

>30 PRINT "HELLO ",»(1>,", YOU ARE A, "YEARS OLD" 

>RUN 

NAME(CR). AGE - FRED 
?15 

HELLO FRED. YOU ARE IS YEARS OLD 

READY 
> 



4.17 DESCRIPTION OF STATEMENTS 

STATEMENT: LET 

MOI^: CO^OMIAND AND/OR RUN 

TYPE: ASSIGNMENT 

The LET statement is used to assign a variable to the value of an expression. The generalized form of 
LET is: ' 

LET [var] = [expr] 

EXAMPLES: 



LET A » 10»SIN(B)/100 or 
IMT A = A -K 1 1 

Note that the = sign used in the LET statement is not equality operator, but rather a "replacement" 
operator and that the statemBW ^Mid be reaid A is replaced bf A pta one. THE WORD L£T IS ALWAYS 
OPTIONAL, i.e. 



LET A <■ 2 is the s«nta as A ». S. 



When LET is omitted the LET statement is called an IMPLIED LET. This document will use the word 
I£T to refer to both the LET statement and the IMPLIED LET smtement. 

The LET statement is also used to assign the string variables, i.e: 

LET «<1)="THIS IS A STRING" or 
LET * < 2 ) =« < 1 ) 

Before Strings can be assigned the STRING [expr], [expr] STATEMENT MUST be executed, or else a 
MEMORY ALLOCATION ERROR will occur. 

SPECIAL FUNCTION VALUES can also be assigned by the LET statement, i.e.: 

LET IE = a2H or 

LET XBYTE(2000H)=5AH or 

LET DBYTE{25)=XBYTE( 1000) 
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4.18 DESCRIPTION OF STATEMENTS 
STATEMENT: ONERRIln num] 

MODE: RUN >r 
TYPE: CONTROL 

The ONERR[ln num] statement lets the programmer handle arithmetic errors, should they occur, during 
program execution. Only ARITH. OVERFLOW, ARITH. UNDERFLOW, DIVIDE BY ZERO, and BAD 
ARGUMENT errors can be "trapped" by the ONERR statement, all other errors are not. If an arithmetic 
error occurs after the ONERR statement is executed, the MCS BASIC-52 interpreter will pass control to 
the line number following the ONERR[ln num] statement. The programmer can handle the error condition 
in any manner suitable to the particular application. Typically, the ONERR[ln num] statement should be 
viewed as an easy way to handle errors that occur when the user provides inappropriate data to an INPUT 
statement. 



With the ONERR[ln num] statement, the programmer has the option of determining what type of error 
occurred. This is done by examining external memory location 257 (lOlH) after the error conditioa is , 
trapped. The error codes are as follows: 



ERiROR 


CODE 


m 


to 


- DIVIDE »Y ZfeRfj 


ERROR 


CODE 




20 


- ARITH. OVERFLOW 


ERROR 


CODE 




30 


-> ARITH. UNDERFLOW 


ERROR 


CODE 




40 


- BAD ARGUMENT 



This location may be examined by using an XBY(257) statement. 
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4.19 DESCRIPTION OF STATEMENTS 

STATEMENT: ONEXl [In num] 
MODE: RUN 
TYPE: CONTROL 

The ONEXl [In num] statement lets the user handle interrupts on the 8052AH's INTl pin with a BASIC 
program. The line number following the ONEXl statement tells the MCS BASlC-52 interpreter which line 
to pass control to when an interrupt occurs. In essence, the ONEXl statement "forces" a GOSUB to the 
line number following the ONEXl statement when the INTl pin on the 8052AH is pulled low. ITie 
programmer must execute a RETI statement to exit from the ONEXl interrupt routine. If this is not done 
all future interrupts on the INTl pin will be "locked out" and ignored until a RETI is executed. 

The ONEXl statement sets bits 7 and 2 of the 8052AH's interrupt enable register IE. Before an interrupt 
can be processed, the MCS BASIC-52 interpreter must complete execution of the staement it is currently 
processing. Because of this, intettupt latency can vary from microseconds to tens of milliseconds. The 
ONTIME [expr], [In num] interrupt has priodty met Ae ONSCl inHbsmf^. So, the ONTDtlS MS|i|K 
can interrupt the ONEXl interrupt routine. 
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4.20 DESCRIPTION OF STATEMENTS' 

STATEMENT: ONTIME [expr], [In num] 
MODE: RUN 
TYPE: CONTROL 

Since MCS BASIC-52 processes a line in the millisecond time frame and the timer/counters on the 8052AH 
operate in the micro-second time frame, there is an inherent incompatibility between the timer/counters on 
the 8052AH and MCS BASIC-52. To help solve this situation the ONTIME [expr], [In num] statement 
was devised. What ONTIME does is generate an interrupt everytime the SPECIAL FUNCTION OPER- 
ATOR, TIME, is equal to or greater than the expression following the ONTIME statement. Actually, only 
the integer portion of TIME is compared to the integer portion of the expression. The interrupt forces a 
GOSUB to the line number ([In num]) following the expression ([expr]) in the ONTIME statement. 

Since the ONTIME statement uses the SPECIAL FUNCTION OPERATOR, TIME, the CLOCKl statement 
mm be executed in or^r for ONTIME to operate. If CLOCKl is not executed the SPECIAL FUNCTION 
OPERATOR, ■TMn,: will n&ver imtemsmt mi,mat madk will happen. 

Since the ONTIME statement generates an interrupt when TIME is greater than or equal to the expressina 

following the ONTIME statement, how can periodic interrupts be generated? That's easy, the ONTIME 
statement must be executed again in the interrupt routine: 

EXAMPLE: 



MO TIME=0 : CLOCUl : ONTIME 2. lOO : DO 
:>20 WHILE TiriE<10 ; END 

MOO PRINT "TIMER INTERRUPT AT -". TIME* "SECONDS" 

>110 ONTIME TIME+2. 100 : RETI 

>RUN 

TIMER INTERRUPT AT - 2. 045 SECONDS 
TIMER INTERRUPT AT - 4. 045 SECONDS 
TIMER INTERRUPT AT - 6. 045 SECONDS 
TIMER INTERRUPT AT - 8. 045 SECONDS 
TIMER INTERRUPT AT - 10. 049 SECONDS 

READY 



You may wonder why the TIME that was printed out was 45 milliseconds greater than the time that the 
interrupt was supposed to be generated. That's because the terminal used in this example was running «t 
4800 BAUD and it takes about 45 milliseconds to print the message TIMER INTERRUPT AT -" ". 



m 



4.20 DESCRIPTION OF STATEMENTS 



If the programmer does not want this delay, a variable should be assigned to the SPECIAL FUNCTION 
OPERATOR, TIME, at the beginning of the interrupt routine. 



EXAMPLE: 



MO TIME=0 : CLOCUl : DNTIfffi 2< 100: 00 
:>20 WHILE TIME<10 : END 
MOO A-TIME 

>110 PRINT "TIMER INTERRUPT AT -", A, "SECONDS " 

M20 ONTIME A+2. tOO : RETI 

>RUN 



TIMER INTERRUPT 
TIMER INTERRUPT 
TIMER INTERRUPT 
TIMER INTERRUPT 
TIMER INTERRUPT 

READY 



AT - 2 SECONDS 
AT - 4 SECONDS 
AT - 6 SECONDS 
AT - a SECONDS 
AT - 10 SECONDS 



Like the ONEXl statement, the ONTIME inteirupt routiae must be exited with a RETI statement, FailpiB 
to do this will "lock-out" all future interrrupts. 

The ONTIME interrupt has priority over the ONEXl interrupt. This means that the ONTIME interrupt can 
interrupt the ONEXl interrupt routine. This priority was established because time related functions in 
control applications were viewed as critical routines. If the user does not want the ONEXl routine to be 
interrupted by the ONTIME interrupt, a CLOCKO or a CLEARI statement should be executed at the 
beginning of the ONEXl routine. The interrupts would have to be re-enabled before the end of the ONEXl 
routine. Ihe ONEXl intermpt cannot interrupt an ONTIME routine. 

The ONTIME statement in MCS BASIC-52 is unique, relative to most BASICS. This powerful statement 
eliminates the need for the user to "test" the value of the TIME operator periodically throughout the 
BASIC program. 
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4.21 DESCRIPTION OF STATEMENTS 

STATEMENT: PRINT or P. (? VERSION 1.1 ONLY) 
MODE: COMMAND and/or RUN 
TYPE: INPUT/OUTPUT 

The PRINT statement directs MCS BASIC-52 to output to the console device. The value of expressions, 
strings, literal values, variables or test strings may be printed out. The various forms may be combined in 
the print list by separating them with commas. If the list is terminated with a comma, the carriage return/ 
line feed will be suppressed. P. is a "shorthand" notation for PRINT. In Vereipn 1.1 ? is also "shorthand" 
notation for PRINT. 

EXAMPLES: 



>PRINT 10»10. 3«3 


>PRINT "MCS-91" 


>PRINT 9. 1E3 


100 9 


MCS-Sl 


9 lOOO 



Values are printed next to one another with two intervening blanks. A PRINT statement with no arguments 
causes a caniage return/Mne feed setpiaac^ to be sent to the console device. 

SPECIAL PRINT FORMATTING STATEMENTS 

TAB([expr]) 

The TAB([expr]) function is used in the PRINT statement to cause data to be printed out in exact locations 
on the output device. TAB([expr]) tells MCS BASIC-52 which position to begin printing the next value 
in the print list. If the printhead or cursor is on or beyond the specified TAB position, MCS BASIC-52 
will ignore the TAB function. 

EXAMPLE: 



>PRINT TAB(5>, "X", TAB(tO), "Y" 
X Y 



SPCaexprI) 

The SPC([expr]) function is used in the PRINT statement to cause MCS BASIC-52 to output the number 
of spaces in the SPC argument. 

EXAMPLE: 



>PRINT A. SPC (5). B 



may be used to place an additional 5 spaces between the A and B over and above the two that would 
normally be printed. 

Sit 
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4.21 DESCRIPTION OF STATEMENTS 



CR 

The CR function is interesting and unique to MCS BASIC-52. When CR is used in a PRINT statement it 
will force a carriage return, but no line feed. This can be used to create one line on .a CRT device that is 
repeatedly updated. 

EXAMPLE: 



>10 FOR I-l TO 1000 
>20 PRINT I. CR. 
>m NEXT I 



will cause the output to remain only on one Une. No line feed will ever I® sent to the console device. 
USING(special characters) 

The USING function is used to tell MCS BASIC-52 what format to display the values that are printed. 
MCS BASIC-52 "stores" the desired format after the USING statement is executed. So, all outputs 
following a USING statement will be in the format evoked by the last USING statement executed. The 
USING statement need not be executed within every PRINT statement unless the programmer wants to 
change the format. U. is a "shorthand" notation for USING. The options for USING are as follows: 

USING(Fx) — This will force MCS BASIC-52 to output all numbers using the floating point format. The 
value of X determines how many significant digits will be printed. If x equals 0, MCS 
BASIC-52 will not output any trailing zeros, so the number of digits will vary depending 
upon the number. MCS BASIC-52 will always ouq)ut at least 3 significant digits even if 
X is 1 or 2. The maximum value for x is 8. 

EXAMPLE: 



MO PRINT USING(F3) , 1, 2, 3 

;>20 PRINT USING(F4) , 1, 2, 3 

:>30 PRINT USING(F5) , 1, 2, 3 

>40 FDR 1=10 TO 40 STEP 10 

:'50 PRINT I 

:>60 NEXT I 

>«yN 

1, 00 E 2. 00 E 3. 00 E 

1. 000 E 2. 000 E 3. 000 E 

1. 0000 E 2. OOOO E 3. COCO E 

1. 0000 E+1 

2. 0000 E+1 

3. 0000 E+1 

4. OOOO E+1 

READY 
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4.21 DESCRIFnON OF STATEMENTS 

USING<#.#) — This will force MCS BASIC-52 to output all numbers using an integer and/or fraction 
fmnat. The number of "#" 's before the decimal point represents the number of sig- 
nificant integer digits that will be printed in the fraction. The decimal point may be 
omitted, in which case only integers will be printed. USING may be abbreviated U. 
USING (###.###), USING(######) and USING(######.##) are all valid 
in MCS BASIC-52. The maximum number of "#" characters is 8. If MCS BASIC-52 
cannot output the value in the desired format (usually because the value is too large) a 
question mark (?) will be printed to console device, dien BASIC will ou^ut the number 
in ffie FR^ FORMAT described betow. 



EXAMPLE: 



MO PRINT USING(««. »#), 1. 2. 3 


:>20 FOR 1 = 1 


TO 120 STEP 20 


>30 PRINT I 




:>40 NEXT I 




:'RUN 




1. 00 2. 


00 3. 00 


1. 00 




21. 00 




41. 00 




61. 00 




81. 00 




? 101 




READY 





NOTE: The USING(Fx) and the USING(#.#) formats will always "align" the decimal points when 
printing a number. This feature makes displayed columns of numbers easy to read. 

USING(O) — This argument lets MCS BASIC-52 determine what format to use. The rules are simple, if 
the number is between ±99999999 and ± . 1, BASIC will display integers and fractions. If 
it is out of this range, BASIC will use the USING(FO) format. Leading and trailing zeros 
will always be suppressed. After reset, MCS BASIC-52 is placed in the USING(O) format. 
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4.22 DESCRIPTION OF STATEMENTS 
STATEMENT: PRINT# or P.# (?# VERSION 1.1 ONLY) 
MODE: COMMAND and/or RUN 
TYPE: INPUT/OUTPUT 

The PRINT#, P.#, and ?# (in Version 1.1 only) statement does the same thing as the PRINT, P. and ? 
(in Version 1 . 1 only) statement except that the output is directed to the list device instead of the console 
device. The BAUD rate to the list device must be initialized by the STATEMENT — BAUD[expr] before 
the PRINT#, P.#, or, ?# smsmm is used. All comments that apply to the PRINT, P. or, ? statement 
apply to the PRINT#, P.#, or ? statement. P.# and ?# (in Vrasion 1.1 only) are "shorthand" notations 
forPiONT*. 
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4.23 DESCRIPTION OF STATEMENTS 



STATEMENTS: PHO„ PHI., PHO.#, PH1.# 



MODE: COMMAM) and/or RUN 



TYPE: INPUT/OUTPUT 



TVT 



The PHO. and PHI . statements do the same thing as the PRD^ statement except that the values are printed 
out in a hexadecimal format. The PHO. statement suppresses two leading zeros if the number to be printed 
is less than 255 (OFFH). The PHI. statement always prints out four hexadecimal digits. The character 
"H" is always printed after the number when PHO. or PHI . is used to direct an output. The values printed 
are always truncated integers. If the number to be printed is not within the range of valid integer (i.e. 
between and 65535 (OFFFFH) inclusive), MCS BASIC-52 will default to the normal mode of print. If 
this happens no "H" will be printed out after the value. Since integers can be entered in either decimal 
or hexadecimal form the statements PRINT, PHO. , and PH 1 . can be used to perform decimal to hex. • lal 
and hexadecimal to decimal conversion. All comments that apply to the PRINT statement apply to the 
PHO. and PHI. statements. PHO.# and PH1.# do the same thing as PHO. and PHI. respectively, except 
bat the ouQMit is directed to the list device instead of the console device. 



EXAMPLES: 



:>PHO. 2»a 

04H 



>PH1. 2*2 
0004H 



>PRINT 99H 
1S3 



>PHO. 100 



>PHO. 1000 
SESH 



>PH1. 1000 
03ESH 



>P. 3EaH 
1000 



>PHO. PI 
03H 
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4.24 DESCRIPTION OF STATEMINTS 

STATEMENT: PRINT®, PHO.@, PH1.@ (VERSION 1.1 ONLY) 
MODE: COMMAND AND/OR RUN 

TYPE: INPUT/OUTPUT ' "^ ^ V 

The PRINT® (P.® OR ?@), PHO.@, and PH1.@ statements do the same thing as the PRINT (P.® or 
?@), PHO., and PHI. statements respectively except that the output is directed to a user defined output 
driver. These statements assume that the user has placed an assembly language ou^ut routine in external 
code memory location 403CH. To enable the @ driver routine the user must SET BIT 27H (39D) in the 
internal memory of the MCS BASIC-52 device. BIT 27H (39D) is BIT 7 of internal memory location 24H 
(36D). This BIT can be set by the BASIC statement DBY(24H) = DBY(24H).OR. 80H or by a user supplied 
assembly language routine. If the user evokes the ® driver routine and this bit is not set, the output will 
be directed to the console driver. The only reason this BIT must be set to enable the @ driver is that it 
adds a certain degree of protection from accidently typing LIST® when no assembly language routine 
exist. The philosophy here is that if the user sets the bit, the user provides the driver or else!!! 

When MCS BASIC-52 calls the user output driver routine at location 403CH, the byte to output is in the 
accumulator and R5 of register bank (RBO). The user may modify the accumulator (A) and the data 
pointer (DPTR) in the assembly language output routine, but cannot modify any of the registers in RBO. 
This is intended to make it real easy for the user to implement a parallel or serial output driver without 
having to do a PUSH or a POP. 
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4.25 DESCRIPTION OF STATEMENTS r : 



STATEMENT: PUSH[expr] 



MODE: COMMAND AND / OR RUN 



TYPE: ASSIGNMENT 



The arithmetic expression, or expressions following the PUSH statement are evaluated and then sequentially 
placed on MCS BASIC-52's ARGUMENT STACK. This statement, in conjunction with the POP statement 
provide a simple means of passing parameters to assembly language routines. In addition, the PUSH and 
POP statements can be used to pass parameters to BASIC subroutines and to "SWAP" variables. The last 
value PUSHED (mto the ARGUMK^T STACK will be the first value POPPED off the ARGUMENT 
STACK. 

VARIATIONS: 

More than one expression can be pushed onto the ARGUMENT stack with a single PUSH statement. The 

expressions are simply followed by a comma: PUSH[expr],[expr], [expr]. The last value PUSHED 

onto the ARGUMENT STACK will be the last expression [expr] encountered in the PUSH STATEMENT. 



EXAMPLES: 



SWAPPING 
VARIABLES 



SUBROUTINE 
PASSING 



10 20 
20 10 



:>io A=io 

:'20 Q=20 

:>30 PRINT A. B 

;.40 PUSH A. B 

>50 POP A. B 

;>60 PRINT A. B 
:'RUN 



>10 PUSH 1, 3, 2 
>20 GOSUB 100 
>30 POP Rl, R2 
>40 PRINT Rl, R2 
>50 END 

MOO REM QUADRATIC A>2. B«3> C-1 IN EXAMPLE 

>1 10 POP A, B, C 

>120 PUSH (-B+SQR (B»B-4»A*C ) ) / <2*A) 
>130 PUSH (-B-SQR(B»B-4»A*C) )/(2*A) 
M40 REJyRN 

>RUN 



READY 



-1 



-. 5 



READY 



m 
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4.m DESCRIPTION OF STATiifllNm 

STATEMENT: POP[var] 

MODE: COMMAND AND / OR RUN 

TYPE: ASSIGNMENT 

The top of the ARGUMENT STACK is assigno! to the variable following the POF statement and tlie 
ARGUMENT STACK is "POPPED" (i.e. incremented by 6). Values can be placed on the stack by either 
the PUSH statement or by assembly language CALLS. NOTE — If a POP statement is executed and no 
number is on the ARGUMBIfT STAdKv an :A*STACS ERROR w^^^^^ 

VARIATIONS: 

More than one variable can be popped off the ARGUMENT stack with a single POP statement. The 
variables are simply followed by a comma (i.e. POP [var],[var], [var]). 

EXAMPLES: 



Sec PUSH statement. 



COMMENT: 

Tlse PUSH and POP statements are unique to MCS BASIC-52. These powerful statements can be used to 
"get around" the GLOBAL variable problems so often encountered in BASIC PROGRAMS. This problem 
arises because in BASIC the "main" program and all subroutines used by the main program are required 
to use the same variable names (i.e. GLOBAL VARIABLES). It is not always convenient to use the same 
variables in a subroutine as in the main program and you often see programs re-assign a number of variables 
(i.e. A = Q) before a GOSUB STATEMENT is executed. If the user reserves some variable names JUST 
for subroutines (i.e. SI, S2) and passes variables on the stack as shewn in the pifevious example, you will 
avoid any GLOBAL variable problems in MCS BASIC-52. 



t1 
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4.27 DESCRIPTION OF STATEMENTS^ t. : ■ 

STATEMENT: PWM [expr], [expr], [expr] 
MODE: COMMAND and/or RUN 

TYPE: INPUT/OUTPUT ✓ 

PWM stands for PULSE WIDTH MODULAnON. What it does is generate a user defined pulse sequence 

on PI. 2 (bit 2 of I/O PORT 1) of the MCS BASIC-52 device. The first expression following the PWM 
statement is the number of clock cycles the pulse will remain high. A clock cycle is equal to 12/XTAL, 
which is 1.085 microseconds at 11.0592 MHz. TTie second expression is flie number of clock cycles flie 
pulse will remain low and the third expression is the total number of cycles the user wishes to output. All 
expressions in the PWM statement must be valid integers (i.e. between and 65535 (OFFFFH) inclusive). 
Additionally, the minimum value for the first two expressions in the PWM statement is 25. 

The PWM statement can be used to create "audiable" feedback in a system. In addition, just for fun, the 
programmer can play music using the PWM ^stemrat. More detdls about using the PWM statement are 
in the appeal. • - 

@(AMPLE: I 



>PWI1 100. lOO. 1000 









At 11.0592 MHz would geno'ate 1000 cycles of a square wave that has a p«iod of 21? mt^roseconds 
(4608 Hz) on PI .2. 
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4^ DESCRIPTION OF STATEMENTS ^ 

STATEMENT: REM 

MODE: RUN (Version 1.0) COMMAND AND/OR RUN (\«rsim 1.1) 
TVre: CONTROL — RiRfOBMS NO (M»ERATION 

REM is short for ^Mark. It does nothing, but allows the user to add conunents to a program. Comments 

are usually needed to make a program a little easier to understand. Once a REM statement appears on a 
line the entire line is assumed to be a remark, so a REM statement may not be terminated by a colon (:), 
however, it may be placed aS^ a colon. This can foe osed to sS3m/ the programnaear to place a commrait 
on each line. 

EXAMPLES: 



MO REM INPUT ONE VARIABLE 
:>20 INPUT A 

;>30 REM INPUT ANOTHER VARIABLE 
:>40 INPUT Q 

>30 REM MULTIPLY THE TWO 
>60 Z=A*B 

>70 REM PRINT THE ANSWER 
>S0 PRINT Z 



MO INPUT A ; REM INPUT ONE VARIABLE 
Z'ZO INPUT 3 : REM INPUT ANOTHER VARIABLE 
>30 Z-A«B : REM MULTIPLY THE TWO 
>40 PRINT Z ;REM PRINT Tm ANSWER 



The following wiU NOT woric because the entire line would be interpreted as a REMaik, so tto I^MQfT 
statement would not be executed: 



MO REM PRINT THE NUMBER : PRINT A 



NOTE — The reason the REM statement was made executable in the command mode in Version 1 . 1 of 
MCS BASIC-52 is that if the user is employing some type of UPLOAD/DOWNLOAD routine with a 
computer, this lets the user insert REM statements, without line num^rs in the text and oat diraictoNi 
tfaem to the MCS BASIC-S2 device. This helps to cons^e memory. 



m 
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4.29 DESCfll^ON OF STATEMENTS - 
STATEMENT: RETI 
MODE: RUN 
TYPE: CONTROL 

The RETI statement is used to exit from interrupts that are handled by an MCS BASIC-52 program. 
Specifically, the ONTIME and the ONEXl interrupts. The RETI statement does the same thing as the 
RETURN statement except that it also clears a software interrupt flags so interrupts can again be acknowl- 
edged. If die user fails to execute the RETI smmeat in the interrupt procedure, all fiitute intern^ will 
be ignored. 
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4.30 DESCRIPTION OF STATEMENTS 

STATEMENT: STOP 
MODE: RUN 
TYPE: CONTROL 

The STOP statement allows the programmer to break program execution at specific points in a program. 
After a program is STOPped variables can be displayed and/or modified. Program execution may be 
resumed with a CONTinue conunand. The purpose of the STOP statement is to allow for easy program 
"debugging." Mote details of the STOP-CONT sequence are covered in the DESCRIPTION OF COM- 
H^O "^ CONT ^tion of this manual . 

EXAMPLE: 



MO FOR 1 = 1 TO 


100 


:>20 PRINT I 




>30 STOP 




: 40 NEXT I 




:>RUN 




1 




STOP - IN UIME 


*0 - . 


READY 




:>CONT 




2 





Note that the hne number printed out after the STOP statement is executed is the line number following 
the STOP statement, NOT the line number that contains the STOP statement!!! 



inteT 
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4.31 DESCRIPTION OF STATEMENTS 

STATEMENT: STRING [expr], [expr] 
MODE: COMMAND ai^or RUN 

TYPE: CONTROL ' > 

The STRING [expr], [expr] statement allocates memory for strings. Initially, no memory is allocated for 
strings. If the user attempts to define a string with a statement such as LET $(!) = "HELLO" before 
memory has been allocated for strings, a MEMORY ALLOCATION ERROR will be generated. The first 
expression in the STRING [expr], [expr] statement is the total number of bytes the user wishes to allocate 
for string storage. The second expression denotes the maximum number of byties that are in each 
These two numbers determine the total numbo- of defined string variables. 

You might think that the total number of defined strings would be equal to the first expression in the 
STRING [expr], [expr] statement divided by the second expression. Ha,ha, do not be so presumptuous. 
MCS BASIC-52 requires one additional byte for each string, plus one additional byte overall. This means 
that the statement STRING 100,10 would allocate enough memory for 9 string variables, ranging from 
$(0) to $(8) and all of the 100 allocated bytes would be used. Note that $(0) is a valid string in MCS 
BASIC-52. 

After memory is allocated for string storage, neither commands, such as NEW nor statements, such as 
CLEAR, will "de-allocate" this memory. The only way memory can be de-allocated is to execute a 
STRING 0,0 statement. STRING 0,0 will allocate no memory to string variables. 



IMPORTANT NOTE 



Every time the STRING [expr], [expr] statement is executed, MCS BASIC-52 executes the equivalent of 
a CLEAR statement. This is a necessity because string variables and numeric variables occupy the same 
external memory space. So", after the STRING statement is executed, all variables are "wiped-out. " Because 
of this, string memory allocation should be performed early in a program (like the first statement or so) 
and string memory should never be "re-allocated" unless the programmer is willing to destroy all defined 
variables. 
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4.32 DESCRIPTION OF STATEMENTS 
STATEMENTS: UIl and UIO (USER INPUT) 
MOTE: COMMAND and/or RUN 
TYPE: CONTROL 
UI1 

The UIl statement permits the user to write specific console input drivers for MCS BASIC-52. After UIl 
is executed BASIC will call external program memory location 4033H when a console input is requested. 
The user must provide a JUMP instruction to an ASSEMBLY LANGUAGE INPUT ROUTINE at this 
location. The appropriate ASCII input from this routine is placed in the 8052AH's accumulator and the 
user input routine returns back to BASIC by executing an ASSEMBLY LANGUAGE RET instruction. 
The user must NOT modify any of the 8052AH's registers in the assembly language program with the 
exception of the MEMORY and REGISTER BANK allocated to the USER. THE ASSEMBLY LAN- 
GUAGE LINKAGE section of this manual explains what memory MCS BASIC-52 allocates to the user 
and how the user may allocate additional memory if needed. 

In addition to providing the INPUT driver routine for the UIl statement, the user must also provide a 
CONSOLE STATUS CHECK routine. This routine checks to see if the CONSOLE DEVICE has a character 
ready for MCS BASIC-52 to read. BASIC CALLS external memory location 4036H to check the CONSOLE 
STATUS. The CONSOLE STATUS ROUTINE sets the CARRY BIT to I (C= 1) if a character is ready 
for BASIC to read and CLEARS the CARRY BIT (C = 0) if no character is ready. Again, the contents of 
the REGISTSIS miist not be changed. MCS BASIC-52 uses the CONSOLE STATUS CHECK routine 
to examine the keyboard for a control-C character during program execution and during a program LISTING. 
This routine is also used to perform the GET operation. 

UIO 

The UIO statement assigns the console input console routine back to the software drivers resident on the 
MCS BASIC-52 device. UIO and UIl may be placed anywhere within a program. This allows the BASIC 
[Hogram to accept inputs from different devices at different times. 

NOTE: The UIO and UIl function is controlled by BIT 30 (lEH) in the 8052AH's internal memory. BIT 
30 is in internal memory location 35.6 (23.6H) i.e. the sixth bit in internal memory location 35 (23H). 
When BIT 30 is SET (BIT 30 = 1), the user routine will be called. When BIT 30 is CLEARED (BIT 30 
= 0), the MCS BASIC-52 input driver routine will be used. The assembly language programmer can use 
diis information to change the input device selection in assembly language. 



4.33 DESCRIPTION OF STATEMENTS 
STATEMENTS: UOl and UOO (USER OUTPUT) 
MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 



UOl 

The UOl STATEMENT permits the user to write specific console output drivers for MCS BASIC-52. 
After UOl is executed BASIC will call external program memory location 4030H when a console output 
is requested. The user must provide a JUMP instruction to an ASSEMBLY LANGUAGE OUTPUT 
ROUTINE at this location. MCS BASIC-52 places the output character in REGISTER 5 (R5) of REGISTER 
BANK (RBO). The user returns back to BASIC executing an assembly language RET instruction. The 
user must NOT modify any of the 8052AH's REGISTERS, including the ACCUMULATOR during the 
user output procedure with the exception of the MEMORY and REGISTER BANK allocated to the user. 
UOl gives tte user the fire^om fo vmlte custom ouQjut routines for MCS BASIC-52. 

UOO 

UOO STATEMENT assigns the console output routine back to the software drivers resident on the MCS 
BASIC-52 device. UOO and UOl may be placed anywhere within a program. This allows the BASIC 
program to ou^ut characters to different devices at different times. 

NOTE: The UOO and UOl fiinction is conlrolled by BIT 28 (ICH) in the 8052AH's internal memory. 
BIT 28 is in the internal memory location 35.4 (23. 4H), i.e. the fourth bit in the internal memory location 
35 (28H). When BIT 28 is SET (BIT 28 = 1), the user routines will be called. When BIT 28 is cleared, 
(BIT 28 = 0), the MCS BASIC-S2 output drivers will be used. The assembly language programmer can 
use this information to change the output device election in assembly langus^. 
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4.34 DESCRIPTION OF STATEMENTS 

STATEMENT: IDLE (VERSION 1.1 ONLY) , 
MODE: RUN 
TYPE: CONTROL 

The IDLE statement forces the MCS BASIC-52 device into a "wait until interrupt mode." Execution of 
statements is halted until either an ONTIME [expr], [In num] or an ONEXl [In numj interrupt is received. 
The user must make sure that one or both of these interrupts have been enabled before executing the IDLE 
instruction or else the MCS BASIC-52 device will enter a "wait forever mode" and for all practical 
purposes the system will have crashed. 

When an ONTIME [expr], [In num] or an ONEXl [In num] is received while in the IDLE mode, the MCS 
BASIC-S2 device will execute the interrupt routine, then execute the statement following the IDLE in- 
strocticm. Hence, the execution of die IDLE instiwsticn is temunated when an interrupt is received. 

While in flie IDLE mode, the MCS BASIC-52 device asserts the /DMA ACKNOWLEDGE pin (PORT 1 , 
BIT 6 = 0) to indicate that the IDL£ instruction is active and that no external bus activity will occur. 
This PIN is physically pin 7 on the MCS BASIC-52 device. When the MCS BASIC-52 device exits from 
die IDLE mode, this pin is placed back into the logically 1 (non-active) state. 

The user may also exit from the IDLE mode with an assembly language interrupt routine. This is accom- 
plished by setting BIT 33 (21H) (which is in Bit addressable RAM location 36.1) when returning from 
the assembly language interrupt routine. If this bit is not set by the user, the MCS BASIC-52 device will 
remain in the IDLE mode when the user assembly language routine returns to BASIC. 

An attempt to execute the IDLE statement in the direct mode will yield a BAD SYNTAX ERROR. 
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4.35 DESCRIPTION OF STATEMENTS 
STATEMENT: RROM [interger] (VERSION 1.1 ONL¥) 
MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 

RROM stands for RUN ROM. What it does is select a program in the EPROM file, then execute the 
program. The integer after the RROM statement selects what program in the EPROM file is to be executed, 
in the COMMAND mode RROM 2 woaW be equivalent to typing ROM 2, flien RUN. But, notice that 
RROM [integp:] is a statement. This means that a program that is already executing can actually force the 
execution of a completely different program that is in the EPROM file. This gives the user the ability to 
"change programs" on the fly. 

If the user executes a RROM [integer] statement and an invalid integer is entered (say 6 programs are 
contaioed in the EI^OM file and tiie ustt Mtras RROM no EMCM is 'm 3ie system), no error ivill 
be generated and MCS BASIC-52 will execute the statement following the RROM [integer] statement. 

NOTE — Every time the RROM [integer] Statement is executed, all variables and strings are set equal to 

zero, so variables and strings CANNOT be passed from one program to another by using the RROM 
[integer] statement. Additionally, all MCS BASIC-52 evoked interrupts are cleared. 
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4.36 DESCRIPTION OF STATEMENTS 

STATEMENTS: LD@ [opr] and ST@ [expr] (VERSION 1.1 ONLY) 

MODE: COMMAND AND/OR RUN 

TYPE: INPUT/OUTPUT 

ST@ 

The ST@ [expr] statement lets the user specify where MCS BASIC-52 floating point numbers are to be 
stored. The expression [expr] following the ST@ statement specifies the address of where the number is 
to be stored and the number is assumed to be on the argument stack. The ST@ [expr] statement is 
designed to be used in conjunction with the LD@ [expr] statemrat. The purpose of these two statements 
is to allow the user to save floating point numbers anywhere in memory with the assumption that the us«" 
will employ some type of battery back-up or non-volatile scheme with this memory. 

LD@ 

The LD@ [expr] statement lets the user retrieve floating point numbers that were saved with the ST@ 
[expr] statement. The expression [expr] following the LD@ statement specifies where the number is stored 
and after executing the LD@ [expr] statement, the number is placed on the argument stack. 



EXAMPLE: Saving and retrieving a ten element array at location array at location OFOOOH 



10 


REM ARRAY SAVE #•* 




20 


FOR I - TO 9 




30 


PUSH Ad) : REM PUT ARRAY VALUE ON 


STACK 


40 


ST« 0F005H+6»I : REM STORE IT. SIX 


BYTES PER NUMBER 


50 


NEXT I 




60 


REM GET ARRAY 




70 


FOR I - TO 9 




80 


LOa 0F005H-I-6*! 




90 


POP B(n 




100 


Next I 





Remember that each floating point number requires 6 bytes of storage. Also note that expression in the 
ST@ [expr] and LD@ [expr] statements point to the most significant byte of the stored number. Hence, 
ST@ (OFOOSH) would save I3as nunte in locations OFOOSB, OiOCMii; OF003H, OFOOZH, OFOOIH, and 
OFOOOH. 
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4.37 DESCRIPTION OF STATEMENTS 

STATEMENT: FGM i \ < 

MODE: COMMAND AND/OR RUN 
TYPE: INPUT/OUTPUT 

The PGM statement gives the user die ability to program an EPROM or EEPROM while executing a 
BASIC program. The PGM statement requires that the user set up internal memory locations 18H 
(24D), 19H (25D), lAH (2<a)), IBH (27H), 1E»<30D) and 16H (31D). Note that these hOemai tnemoqr<^ 
locations aie normally reserved for the user!! 

The User must itdtidize these internal m^nory locations with the following: 
EXAMPLE: 



LOCATION 

IBH: 19H 
(27D: 25D) 



lAH: IQH 
(26D:24D> 



IFH: lEH 
(31D: 30D) 



CONTENTS 

THE ADDRESS OF THE SOURCE INFORMATION THAT IS TO BE 
PROGRAMMED INTO THE EPROM . LOCATION 19H IS THE LOW 
BYTE AND LOCATION IBH 18 THE HIOH BYTE 

THE ADDRESS - 1 OF THE EPROM LOCATION(S> THAT ARE TO 
SE PROGRAMMED. LOCATION 18H IS TH LOU BYTE AND 
1.0CATI0N lAH IS THE HIGH BYTE 

THE NUMBER OF BYTES THAT THE USER WANTS TO PROGRAM 
LOCATION lEH IS THE LOW BYTE AND LOCATION IFH IS 
THE HIGH BYTE 



J ! 



The user must also initialize, the width of the desired EPROM programming pulse and store the value in 
ii^mal memory locations 40H (64D) (hi^ byte) and 41H (65D) Gow byte). The reload for a 50 millisecond 
EPROM progriumning pulse is calcidated as follows: 



10 REM R = RELOAD VALUE, W 

20 W = . 05 

30 R « 65536 - W * XTAL/12 

40 DBY(40H> » R/25& 

50 DBY(41H) » R . AND. OFFH 



WIDTH IN SECONDS (SO MILLISECONDS) 



In addition, the user must also SET or CLEAR BIT 38.3 (26. 3H) to select the INTELligent EPROM 
programming algorithm. The Bit is SET to select INTELligent programming and CLEARED to select the 
normal 50 millisecond algorithm. To SET the BIT, execute a DBY(38) = DBY(38) OR. 8H Statement, 
to CLEAR the BIT, execute a DBY(38) = DBY(38) .AND. 0F7H instruction. 
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4.3 7 DESCRIPTION OF STATEMENTS 
IMPORTANT NOTE! 

When executed in the RUN mode. The PGM statement will not generate an error if the EPROM fails to 
program properly. Instead, the control of the program will be passed back to the user just as if the EPROM 
programmed properly. The user must then examine locations lEH and IFH. If the contents of locations 
lEH and IFH both equal zero, then the EPROM prognunmed properly. If they do not, then an ERROR 
occurred during the programming process. The user can then examine locations 1AH:18H to detennii» 
what location in the EPROM failed to program. 

Well, this sounds like a lot to do just to program an EPROM, but it's not so bad. The following program 
is an example of a universal EPROM/EEPROM programmer built around MCS BASIC-52. This program 
can program a block of RAM into an EPROM or EEBIOM tiiat is addressed at 8000H or above. 



EXAMPLE: 



10 PRINT "UNIVERSAL PROM PROGRAMMER" : PRINT "WHAT TYPE OF DEVICE ?" 

20 PRINT PRINT "1 = EEPROM" PRINT "2 - INTELLIGENT EPROM" 

30 PRINT "3 - NORMAL (50 MS) EPROM" : PRINT INPUT "TYPE (1,2.3) - ". T 

40 ON (T-1) GOSUB 340.350,360 

50 REM this <ets up intelligent programming if needed 

60 IF M«. 001 THEN DBy(26>«DBY(26> . OR. 8 ELSE DBY(26)-DBY(26>. AND. 0F7H 

70 REM calculate pulse width and save it 

80 PUSH (6S336-(W»XTAL/I2) ) : GOSUB 380 

90 POP Gl : DBY(40H>=01 : POP 01 : DBY(41H)=G1 : PRINT 

100 INPUT •• STARTING DATA ADDRESS - ",S : IF S012. OR. S>OFFFFH THEN 100 

110 PRINT INPUT " ENDING DATA A0Bfffi88 - ".E 

120 IF E<S. OR. E>OFFFFH THEN 110 

130 PRINT INPUT " PROM ADDRESS - ",P : IF P<8000H. OR. P>OFFFFH THEN 130 

140 REM calculate the number of bytes to program 

150 PUSH (E-S> + 1 : GOSUB 380 : PW 01 : DBY(31)»01 : POP 01 : NYOOoOl. 

160 REM set up the eprom address 

170 PUSH (P-n : GOSUB 380 : POP Gl : 0»YIS»>-O1 : POP 01 : DBY(24>»01 

180 REM set up the source address 

190 PUSH S : GOSUB 380 : POP Gl ; DBY(27)=G1 : POP Gl : DBY<2S>=G1 

200 PRINT PRINT "TYPE A 'CR ' ON THE KEYBOARD WHEN READY TO PROGRAM" 

210 REM wait for a 'cr' then program tll« tproffl 

220 X=GET : IF XOODH THEN 220 

230 REM program tha aprem 

240 PGM 

250 REM see if any errors 

260 IF (DBY(30). OR. DBY(31) )=0 THEN PRINT "PROGRAMMING COMPLETE" : END 

270 PRINT PRINT "♦»»ERROR»»»ERROR»»»ERRDR«»»" : PRINT 

280 REM these routines calculate the address of the source and 

290 REM aproffl location that failed to program 

300 81<'DBY(25>i^2S6«0BY(27) : Sl-81-1 : Dl-DBY(24)-f296*0BY(26) 

310 PHO. "THE VALUE ".XBY(Si>. : PHI. " UAS READ AT LOCATION ".SI : PRINT 

320 PHO. "THE EPROM READ ".XBY(Dl). : PHI. " AT LOCATION ".Dl : END 

330 REM that* subroutlna* sot up tha pulse Midth 

340 0009 : RETURN 

350 001 : RETURN 

360 09 : RETURN 

370 REM this routina takes tha top of stack and raturns high, low bytes 

380 POP 01 : PUSH (01. AND. OFFH) : PUSH ( INT(01/S96) ) : RETURN 
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CHAPTER 5 

Description of Aritlimetic/Logic Operators and Expressions 



5.1 DUAL OPERAND OPERATORS 

MCS BASIC-52 contains a complete set of ariflimetical and logical operators. Operators are divided into 
two groups, dual operand or dyadic operators and single operand or unary operators. The generalized form 
of all dual operand instructions is as follows: 

[expr] OP [expr] , where OP is one of the following operators: 



+ ADDITION OPERATOR 
EXAMPLE: 



PRINT 3+2 
9 


/ DIVISION OPERATOR 




EXAMPLE: 




PRINT 100/3 
20 





EXPONENTIATION OPERATOR 

Raises the first expression to the power of the second expM«ssion. The power any number can be raised to 

i^S limited to 255. The notation ** was chosen instead of the sometimes used | symbol because the "up 
arrow" symbol appears different on various terminals. To eliminate confusion the ** notation was chosen. 

EXAMPLE: 



PRINT 2**3 
8 


* MULTIPLICATION OPERATOR 




EXAMPLE: 




PRINT 3*3 
9 


- SUBTRACTION OPERATOR 




EXAMPLE: 




PRINT 9-6 
3 
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5.1 DUAL OPERAND OPERATIONS 
.AND. LOGICAL AND OPERATOR 
EXAMPLE: 



PRINT 3. AND. 2 
2 



.OR. LOGICAL OR OPERATOR 
EXAMPLE: 



PRINT 1. OR. 4 
3. 



.XOR. LOGICAL EXCLUSIVE OR OPERATOR 
EXAMPLE: 



PRINT 7. XOR. 6 
I 



COMMENTS ON LOGICAL OPERATORS -AND., .OR., and .XOR. 

These operators perform a BIT-WISE logical function on valid INTEGERS. That means both arguments 
for these operators must be between and 65535 (OFFFFH) inclusive. If they are not, MCS BASIC-52 
will generate a BAD ARGUMENT ERROR. All non-integer values are truncated, NOT rounded. 

You may wonder why the notation .OP. was chosen for the logical functions. The only reason for this is 
that MCS BASIC-52 eliminates ALL spaces when it processes a user line and inserts spaces before and 
after STATEMENTS when it LISTS a user program. MCS BASIC-52 does not insert spaces before and 
after operators. So, if the user types in a line such as 10 A = 10 * 10, this line will be listed as 
10 A = 10*10. All spaces entered by the user before and after the operator will be eliminated. The .OP. 
notation was chosen for the logical operators because a line entered as 10 B = A AND B would be listed 
as 10 B = AANDB. This just looked confusing, so the dots were added to the logical instructions and the 
previous example would be listed as 10 B = A.AND.B, which is easier to read. 
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5.2.1 UNARY OPERATORS — GENERAL PURPOSE 
ABS([expr]) 

Itetums die ABSOLUTE VALUE of Ifee expansion. »• 
EXAMPLES: 



PRINT ABS<9) PRINT ABS(-9> 

5 S 



NOT([expr]) 

Returns a 16 bit one's complement of the expression. The expression must be a valid integer (i.e. betwe@tt 
and 6S535 (OFFFFH) inclusive). Non-integers will be truncated, not rounded. 

EXAMPLES^ 



PRINT NOT (63000) 


PRINT NOT<0> 


939 


69939 



INT([expr]) 

Returns the integer portion of the expression. 
EXAMPLES: 



PRINT INTO. 7) 


PRINT INT (100. 876) 


3 


100 



SGN([expr]) 

Will return a value of + 1 if the argument is greater than zero, zero if the argument is equal to zero, and 



— 1 if the argument is le 


^ than z^. 




EXAMPLES: 






PRINT SeN<92) 


PRINT mm<Qi 


PRINT SGN(-a> 


1 





-1 



5.2.1 UNARY OPERATORS ®1M1RAL W«P0S1 
SQR([expr]) 

Returns the square root of the argument. The argument may not be less than zero. The result returned will 
be accurate to within + / - a value of 5 on the least significant digit. 

EXAMPLES: 



PRINT SQR(9) 


PRINT SQR(45) 


PRINT SQR(IOO) 


3 


6. 70@S03S 


10 



Returns a pseudo-random number in the range between and 1 inclusive. The RND operator uses a 16- 
bit binary seed and generates 65536 pseudo-random numbers before repeating the sequence. The numbers 
generated are specifically between 0/65535 and 65535/65535 inclusive. Unlike most BASICS, the RND 
operator in MCS BASIC-52 does not require an argument or a dummy argument. In fact, if an argument 
is placed after the RND operator, a BAD SYNTAX error will occur. 

EXAMPLES: 



PRINT RND 
30278477 



PI 

PI is not really an operator, it is a stored constant. In MCS BASIC-52, PI is stored as 3.1415926. Math 
experts will notice that PI is actually closer to 3.141592653, so proper rounding for PI should yield the 
number 3.1415927. The reason MCS BASIC-52 uses a 6 instead of a 7 for the last digit is that errors in 
the SiN, COS and TAN operators were found to be greater when the 7 was used instead of 6. This is 
because the number Pl/2 is needed for these calculations and it is desireable, for the sake of accuracy to 
have the equation PI/2 + PI/2 = PI hold true. This cannot be done if the last digit in PI is an odd number, 
so the last digit of PI was rounded to 6 instead of 7 to make these calculations more accurate. 



« 
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5.2.2 UNARY OPERATORS — LOG FUNCTIONS 
LOG((expr]) 

Returns the mtutal iogarithm of die arguimnt The aigunaeot Ausfe be gml^^m 0. This cak»ilati«HK!ll 
carried out to 7 sigmficant digits. 

EXAMPLES: 



PRINT LaC( 12) PRINT LQ0<EXP<1) ) 

2. 484906 1 



EXP([expr]) 

This function raises the number "e" (2.7182818) to the power of the argument. 
EXAMPLES: 



PRINT EXP(l) PRrUCT ||XI»(LP©<a) > 

2. 7182818 2 



5.2.3 UNARY OPERATORS — TRIG FUNCTIONS 
SIN([expr]) 

Returns the SIN of the argument. The argument is expressed in radians. Calculations are canied out to 7 
significant digits. The argument must be between ±200000. 

EXAMPLES: 



PRINT SIN<PI/4> 


PRINT SINfO) 


. 7071067 






COS([expr]) 

Returns the COS of the argument. The argument is expressed in radians. Calculations are carried out to 
7 significant digits. The argunKnt must be between ±200000. 

EXAMPLES: 



PRINT CQS(PI/4) 


PRINT CQS(O) 


. 7071067 


1 
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5.2.3 UNARY OPERATORS — TRIG FUNCTIONS 
TAN([expr]) 

Returns the TAN of the ai^m^t. Tbe iffgument is expcessed m tadism. The arguo^nt m^t be between 
±200000. 

EXAMPLES: 



PRINT TAN(Pl/4) PRINT TAN(O) 
1 



ATN([expr]) 

Returns the ARCTANGENT of the argument. The result is in radians. Calculations are carried out to 7 
significant digits. The ATN operator returns a result between -PI/2 (3.1415926/2) and PI/2. 

EXAMPLES: 



PRINT ATN(PI) PRINT ATN(l) 

1.2626272 .78539804 



COMMENTS ON TRIG FUNCTIONS 

The SIN, COS, and TAN operators use a Taylor series to calculate the function. These operators first 
reduce tiie argument to a value fliat is between and PI/2. This reduction is accomplished by the following 
equation: 

Rm>UCED ARGUMENT = (user arg^I - INT(iiser arg^I)) * PI 

The REDUCED ARGUMENT, from the above equation, will be between and PI. The REDUCED 
ARGUMENT is then tested to see if it is greater than PI/2. If it is, then it is subtracted from PI to yieM 
the final value. If it isn't, then the REDUCED ARGUMENT is the final value. 

Although this method of angle reduction provides a simple and economical means of generating the 
appropriate arguments for a Taylor series, there is an accuracy problem associated with this technique. 
The accuracy |HX)blem is noticed when the user argument is large (i.e. greater than KXX)). That is because 
significant digits, in the decimal (fraction) portion of REDUCED ARGUMENT are lost in the (user arg/PI 
— INT(user arg/PI)) expression. As a general rule, try to keep the arguments for the TRIG functions as 
small as possible! 
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5.3 UNDERSTANDING PRECEDENCE OF OPERATORS 

The hierarchy of mathematics dictates that some operations are carried out before others. If you understand 
the hierarchy of mathematics, it is possible to write complex expressions using only a minimum amount 
of parentheses. It's easy to illustrate what ^eoedence is dl ^boiit, examine the following equation: 

4 + 3*2 = ? 

Should you add (4 + 3) then multiply seven by 2, or should you multiply (3*2) then add 4? Well, the 
hierarchy of mathematics says that multiplication has precedence over addition, so you would multiply 
(3*2) first then add 4. So, 

I 

4+3*2 = 10 I 

The rules for the hierarchy of math are simple. When an expression is scanned from left to right an operation 
is not performed until an operator of lower or equal precedence is encountered. In the example addition 
could not be performed because multiplication has higher precedence. Hie precedence of operators tan 
highest to lowest in MCS BASIC-52 is as follows: 

DOPERATORS THAT USE PARENTHESES ( ) 

2) EXPONENTATION (**) 

3) NEGATION (-) 

4) MULTIPLICATION (*) AND DIVISION (/) 

5) ADDITI0N ( + ) AND SUBTRACTION (-) 

6) RELATIONAL EXPRESSIONS (=, <>, >, > = , <, <=) 

7) L0GICAL AND (.AND.) 

8) L0GICAL OR (.OR.) 

9) LOGICAL XOR (.XOR.) 

Relative to op^atcw p^edence, the rule of thumb should always be; when in doubt, use parentiieses. 



— , 

I 
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5.4 HOW RELATIONAL EXPRESSIONS WORK 

Relational expressions involve the operators = , <>, >, > = , <, and < = . These operators are typically 
used to "test" a condition. In MCS BASIC-52 relational operators return a result of 65535 (OFFFFH) if 
tbo relational expression is true, and a result of 0, if the relation expression is false. But, where is the 
result returned? It is returned to the aifumeat stack. Because of tiiis, it's possible to actually display the 
result of a relational expression. 

EXAMPLES: 



PRINT l-O 


PRINT 1>0 


PRINT <<V<>A 


PRINT 





63535 





63539 



It may seem strange to have a relational expression actually return a result, but it offers a unique benefit 
in that relational expressions can actually be "chained" together using the logical operators .AND., .OR., 
and .XOR.. This makes it possible to test a rather complex condition witii ONE statement. 

EXAMPLE: 

— ___ _ , • 

>10 IF A<B. Am. A>€. m. A>0 THEN; ...... 



Additionally, the NOT([expr]) operator can be used. 
EXAMPLE: 



>10 IF NaT(A>B). AND. A<C THEN, 



By "chaining" together relational expressions with logical operators, it is possible to test very particular 
conditions with one statement. When using logical operators to link together relational expressions, it is 
very important fliat the programmer pay careful attention to the precedence of operators. The logical 
operators were assigned lower precedence, relative to relatioml expressions, just to make the linking of 
relational expressions possible without using parentheses. 
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CHAPTER 6 
Description of String Operators 



6.1 WHAT ARE STRINGS? 

A string is a character or a bunch of characters that are stored in memory. Usually, the characters stored 
in a string make up a word or a sentence. Strings are handy because they allow the programmer to deal 
widi words instead of numbers. This is useful because it allows one to write "friendly" programs, where 
hidividuals can be referred to by their names instead of a numbor. 

MCS BASIC-52 contains ONE dimensioned string variable, $([expr]). The dimension of the string variiAde' 
(the [expr] value) ranges from to 254. This means that 255 different strings can be defined and manipulated 
in MCS BASIC-52. Initially, NO memory is allocated for strings. Memory is allocated by the STRING 
[expr] , [expr] STATEMENT. The deteils of this ^atement are covwed in the DESCRIPTION OF STATE- 
N^4TS chapter of this manual. 

In MCS BASIC-52, strings can be defined in two ways, wirti the LET STATEMENT and with ttie INPUT 
STATEMENT. 

EXAMPLE: 



MO STRING 100, 20 
:>20 »(1)="THIS IS A STRING. " 
;>30 INPUT "WHAT'S YOUR NAME? - 
;>40 PRINT »(1>, *(2) 

>RUN 

WHAT'S YOUR NAME? - FRED 
THIS IS A STRING, FRED 



STRINGS can also be assigned to each other with a LET statement. 
EXAMPLE: 

' ' 

«(2)-«<l) 



Would assign the STRING value in $(1) to the STRING $(2). 



m 
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6.2 THE ASC OPERATOR 

In MCS BASIC-52, two operators manipulate STRINGS. These operators are ASC( ) and CHR( ). Ad- 
mittedly, the string operators contained in MCS BASIC-52 are not quite as powerful as the string operators 
contained in some BASICS. But surprisingly enough, by using the string operators available in MCS 
BASIC-52 it is possible to manipulate strings in almost any way imaginable. This in itself is a commendable 
feat since MCS BASIC-52 was designed primarily to be a sophisticated BASIC language oriented controller, 
not a string manipulator. The string operators available in MCS BASIC-52 are as follows: 

ASC( ) 

The ASC( ) operator returns the integer value of the ASCII character placed in the parentheses. 
EXAMPLE: 



>PRINT ASC (A) 
69 



65 is the decimal representation for the ASCII character "A." In addition, individual characters m a iie- 
defined ASCII string can be evaluated with the ASC( ) operator. , , . 

EXAMPLE: 



>10 «(1)=»"THIS IS A STRINO" 

>20 PRINT *<!> 

>30 PRINT ASC(«(1). 1) 

>RUN 

THIS IS A STRING 
84 



When the ASC( ) operator is used in the manner shown above, the $([expr]) denotes what string is being 
accessed and the expression after the comma "picks out" an individual character in the string. In the above 
example, the first character in the string was picked out and 84 is the decimal representation for the ASCII 
character "T." 



83 



inter 



MGS® BASIC-S2 



6.2 THE ASC OPERATOR 
EXAMPLE: 



>10 «( 1 ) = "ABCDEFGHIJi<L" t . / 

>20 FOR X=l TO 12 

>30 PRINT ASC(«<1'). X). - • 

>40 NEXT X 

>RUN 

63 66 67 68 69 70 71 72 73 74 7S 76 



The numbers printed in the previous example are die values that represent the ASCII characters A,B,C, 

. . . L. - - - - 

Additionally, the ASC( ) operator can be used to change individual characters in a defined string. ^ 
EXAMPLE: 



MO »( 1 ) = "ADCDEFGHIJKt,"' 

>20 PRINT »( 1 ) 

:'30 ASC(»(1). 1)=75 

>40 PRINT S(l) 

>50 ASC(*( 1), 2)»ASC<S(1J*^) 

;>60 PRINT Sd) ""^ 

>HUN 

ABCDEFGHIJKL 
KBCDEFGHIJKL 
KCCDEFCHIJKL 



In general, the ASC( ) operator lets the programmer man^mlate iadividital d^ractm in a string. A single 
program can determine if two strings are identical. 

EXAMPLE: ^ 



MO •( 1 )-"SECRET" : REM SECRET IS THE PASSWORD 
>20 INPUT "WHAT'S THE PASSWORD - ".•<2> 
:>30 FOR 1-1 TO 6 

>40 IF ASC(*( 1 ). I )-ASCt«{3), X > THEH NEXT I ELSE 70 
>50 PRINT "YOU GUESSED IT?" 
>60 END 

>70 PRINT "WRONG. TRY AGAIN" : GOTO 20 
>RUN 



WHAT'S THE PASSWORD - SECURE 
WRONG. TRY AGAIN 
WHAT'S THE PASSWORD - SECRET 
YOU GUESSED IT 
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6.3 THE CHR OPERATOR 

CHR( ) 

The CHR( ) operator is the converse of the ASC( ) operator. It converts a numeric expression to an ASCII 
character. 

EXAMPLE: 



;PRINT CHRt63) 



Like the ASC( ) operator, the.CHR( ) operator can also "pick out" individual characters in a defined 
ASCU string. \ 

EXAMPLE: 



MO *<1) = "MCS BASIC-52" 

:>20 FOR 1 = 1 TO 12 : PRINT CHR(»{1),I), ; NEXT I 
;>30 PRINT : FOR 1 = 12 TO 1 STEP -1 
>40 PRINT CHR(»<1),I), : NEXT I 
>RUN 

MCS BASIC-52 
2S-CISAB SCM 



In the above example, the expressions contained within the parentheses, following the CHR operator have 
the same meaning as the expressions in the ASC( ) op^tGar. j , |;- 

Unlike the ASC( ) operator, the CHR( ) operator CANNOT be assigned a value. A statement such as 

CHR($(1),1) = H, is INVALID and will generate a BAD SYNTAX ERROR. Use the ASC( ) operator 
to change a value in a string. The CHR( ) operator can only be used within a print statement! 
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CHAPTER 7 
Special Operators 



7.1 SPECIAL FUNCTION OPERATORS 

SPECIAL FUNCTION OPERATORS are called SPECIAL FUNCTION OPERATORS because they di- 
rectly manipulate the I/O hardware and the memory addresses on the 8052AH device. All SPECIAL 
FUNCTION OPERATORS, with the exception of CBY([exprl) and GET, can be placed on eittear side of 
die replacement operator ( = ) in a LET STATEMENT. ] 

EXAMPLES: 



A = DBY(IOO) and DBY(IOO) = A+2 



Both of the above are valid statements in MCS BASIC-52. The SPECIAL FUNCTION OreRATORS W 
MCS BASIC-52 include the following: _ . , 

CBY«exprl) ; 

The CBY([expr]) operator is used to retrieve data from the PROGRAM or CODE MEMORY address space 
of the 8052 AH. Since CODE memory cannot be written into cm the 8052AH, the CBY(ie)Cpf]) openit!^ 
cannot be assigned a value. It can only be read. 

EXAMPLE: A = CBY(IOOO) Causes the value in code memory space 1000 to be assigned to the variable 
A. The argument for the CBY([expr]) operator MUST be a valid integer (i.e. between and 6553^ 
(OFFFFH) ). If it is not, a BAD ARGUMENT ERROR will occur. "' 

DBY([expr]) 

The DBY([expr]) operator is used to retrieve or assign a value to the 8052AH's internal data memory. 
Both the value and argument in the DBY operator must be between and 255 inclusive. This is because 
&ere are only 2S6 internal memory locations in the S052AH and one byte can only represent a quantity 
between md 255 inclusive. 

EXAMPLES: 



A=DBY(B) and DBY(250> =■ CBY(IOOO) 



The first example would assign variable A the value that is in internal memory location B. B would have 
to be between and 255. The second example would load internal memory location 250 with the same 
value that is in program memory location 1000. 
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XBY([expr]) 

The XBY([expr]) operator is used to retrieve or assign a value to the 8052AH's external data memory. 
The argument in the XBY([expr]) operator must be a valid integer (i.e. between and 65535 (OFFFFH) ). 
The value assigned to the XBY([expr]) operator must be between and 255. If it is not a BAD ARGUMEfS" 
ERROR will occur. 

EXAMPLES: 



XBY(4000H>»0]}Y( 100) and A«XBY(OFOOOH) 



The first example would load external memory location 4000H with the same value that was in internal 
memory location 100. The second example would make the variable A equal to the value in external 
memory location OFOOOH. 

GET 

The GET operator only produces a nKaningful result when used in the RUN mode. It will always return 
a result of zero in the command mode. What GET does is read the console input device. Actually, it takes 
a "snapshot" of the console input device. If a character is available from the console device, the value 
of the character will be assigned to GET. After GET is read in the program, GET will be assigned the 
value of zero until another character is sent from the console device. The following example will print the 
decimal representation of any character sent from die console: 

EXAMPLE: 



MO 


A=OET 




>20 


IF A<:.0 THEN PRINT A 


:>30 


GOTO 10 








65 


(TYPE 


"A" ON CONSOLE) 


49 


(TYPE 


"1" ON CONSOLE) 


24 


(TYPE 


"CONTROL-X" ON COMSOLEJ 


50 


(TYPE 


"2" ON CONSOLE) 



The reason the GET operator can be read only once before it is assigned a value of zero is that this 
implementation guarantees that the first character entered will always be read, independent of where the 
GET operator is placed in the program. 



MCS® BASIC-52 



7.1 SPECIAL FUNCTION OPERATORS ^ .i -C - • i . 

The following operators directly manipulate the 8052AH's special function registers. Specific details of 
the operation of these registers is in the MICROCONTROLLER USERS HANDBOOK, available from 
INTEL. 

IE ^ 

The IE operator is used to retrieve or assign a value to the 8052AH's special function register IE. Since 
the IE register on the 8052AH is a BYTE register, the value assigned to IE must be between and 255. 
The IE register on the 8052AH contains an unused bit, BIT IE. 6. Since this bit is "undefined," it may 
be read as a random one or zero, so the user may want to mask this bit when reading tiie IE register. This 
can be done with a statement like A = lE.AND.OBFH. The only statements in MCS BASIC-52 that write 
to the IE register are the CLOCKO, CLOCKl, ONEXl, CLEAR, and CLEARI statements. 

EXAMPLES: 



IE - 81H and A - IE. AND. OBFH 



IP 

The IP operator is used to retrieve or assign a value to the 8052AH's special function register IP. Since 
the IP register on the 8052AH is a BYTE register, the value assigned to IP must be between and 255. 
The IP register on the 8052AH contains two unused bits, BIT IP. 6 and IP. 7. Since these bits are "un- 
defined," they may be read as a random 1 or 0, so the user may want to mask these bits when reading 
the IP register. This can be done with a statement such as B = IP.AND.3FH. MCS BASIC-52 does not 
write to the IP register during initialization, so user can establish whatever interrupt priorities are required 
in a given application. 

EXAMPLES: 



IP = 3 and A = IP. AND. 3FH 



P0RT1 

TTie PORTl operator is used to retrieve or assign a value to the 8052AH's PI I/O port. Since PI on the 
8052AH is a BYTE wide register, the value assigned to PI must be between and 255 inclusive. Certain 
bits on PI have pre-defined functions. If the user does not implement any of the hardware associated with 
these pre-defined functions. The PORTl instruction can be used in any manner ^propriate in the appUcation. 
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PCON 

The PCON operator is used to retrieve or assign a value to the 8052AH's PCON register. In the 8052AH, 
only the most significant bit <rf the PCON registw is used, all o&er bits uodeftned. Setting this bit will 
double the baud rate if TIMER/COUNTER 1 is used as the baud rate generator for the serial port. PCON 
is a byte register. 

RCAP2 

The RCAP2 operator is used to retrieve and/or assign a vaitie to toe 8052AH's speeM tenction registers 
RCAP2H and RCAP2L, This operator treats RCAP2H and RCAP2L as a 16-bit register pair. RCAP2H is 
the high byte and RCAP2L is the low byte. The RCAP2H and RCAP2L registers are the reload/capture 
registers for TIMER2. The user must use caution when writing to RCAP2 register because RCAP2 conttbis 
the BAUD rate of the serial port on the MCS BASIC-52 device. The following can be used to determine 
what BAUD rate the MCS BASIC-52 device is operating at: 

BAUD = XTAL/(32*(65536-RCAP2) ) 

T2CON 

The T2CON operator is used to retrieve and/or assign a value to the 8052AH's special function register 
T2CON. The T2CON is a byte register fliat controls TIMER2's mode of operation and detennines which 
timer (TIMERl or TIMER2) is used as the 8052AH's baud rate generator. MCS BASIC-52 initializes 
T2CON with the value 52 (34H) and assumes that its value is never changed. Randomly changing the 
value of T^^N, without knowing what you ai» doing can ' 'crash' ' the serial port on 8052AH. Bewafe! 



MCS® BASIC-52 



7.1 SPECIAL FUNCTION OPERATORm t. 

TCON 

The TCON operator is used to retrieve and/or assign value to the 8052AH's special function register TCON. 
TCON is a byte register that is used to enable or disable TIMERO and TIMER 1, plus the interrupts that 
fflre associated with these timers. Additionally, TCON determines whether the external interrupt pins on 
the 8052AH are operating in a level sensitive or edge-triggered mode. MCS BASlC-52 initializes TCON 
with the value 244 (0F4H) and assumes that it is never changed. The value 244 (0F4H) places both TIMERO 
and TIMER 1 in the run (enabled) mode. If the user disables the operation of TIMERO, by clearing BIT 
4 in the TCON register, the REAL TIME CLOCK will NOT work. If the user disables the operation of 
TDVIERl, by clearing BIT 6 in the TCON register, the EPROM programming routines, the software sedal 
port, and the PWM statertient will NOT work. Use caution when changing TCON!!! 

TMOD 

The TMOD operator is used to retrieve and/or assign a value to the 8052AH's special function register 
TMOD. TMOD is a byte register that controls TIMERO and TIMERl's mode of operation. MCS BASIC-52 
initializes the TCON register with a value of 16 (lOH). The value 16 (lOH) places TIMERO in mode 0, which 
is a 13-bit counter mode and TIMERl in mode 1, which is a 16-bit counter mode. MCS BASIC-52 
assumes that the modes of these two timer/counters are never changed. If the user changes the mode of 
TIMERO, the REAL TIME CLOCK will not operate properly. If the user changes the mode of TIMERl, 
EPROM programming, the software serial port, and the PWM statement will not work properly. If the 
user does not use these features available ia MCS BASICtII, «i£h^ timei^eouQtier can placed ii ai^ 
mode required by the specific application. 
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TIME 

The TIME operator is used to retrieve and/or assign a value to the REAL TIME CLOCK resident in MCS 
BASIC-52. After reset, TIME is equal to 0. The CLOCK! statement enables the REAL TIME CLOCK. 
When the REAL TIME CLOCK is enabled, the SPECIAL FUNCTION OPERATOR, TIME will increment 
once every 5 milliseconds. The TIME operator uses TIMERO and the interrupts associated with TLMERO 
on the 8052AH. The unit of TIME is seconds and the appropriate XTAL value must be assigned to insure 
that the TIME operator is accurate. 
• 

When TIME is assigned a value with a LET statement (i.e. TIME = 100), only the integer portion of 
TIME will be changed. 

EXAMPLE: 



:>CL0CK1 


(enable REAL TIME CLOCK) 


;>CLOCKO 


(disable REAL TIME CLOCK) 


>PRINT TIME 
3. 319 


(display TIME) 


^TII« - 


ism* TIMt - 0> . 


>PRINT TIME 
. 31S 


(display TIME) 

(only the integer is changed) 


The "fraction" portion of TIME can be changed by 
manipulating the contents of internal memory 
location 71 (47H). This is accomplished by a DBY(71) 
statement. Note that each count in internal memory 
location 71 (47H) represents 5 milliseconds of TIME. 
Continuing with the EXAMPLE; 


>DBY(71) - 


(fraction of TIME - 0> 


>PR1NT TIME 





>DBY(71 ) = 3 


(fraction of TIME = 3, 15 ms ) 


:>PRINT TIME 
1. 5 E-2 
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The reason only the integer portion of TIME is changed when assigned a value is that it allows the user 
to generate accurate time intervals. For instance, let's say you want to create an accurate 12 hour clock. 
There are 43200 seconds in a 12 hour period, so an ONTIME 43200, [In num] statement is used. Now, 
when the TIME interrupt occurs the statement TIME = is executed, but the millisecond counter is not 
le-sssigned a vsim so if interrupt latency -hajqi^s to exce^ S milliseconds, tiat clock will still r^iriaib 
accurate. 

TIMERO 

The TIMERO operator is used to retrieve or assign a value to the 8052AH's special function registers THO 
and TLO. This operator treats the byte registers THO and TLO as a 16-bit register pak. THO is tiie high 
byte and TLO is the low byte. MCS BASlC-52 uses THO and TLO to implement the REAL TIME CLOCK 
function. If the user does not implement the REAL TIME CLOCK function (i.e. does not use the statement 
CLOCK 1) in the BASIC program THO and TLO may be used in any manner suitable to the particular 
application. 

TIMER1 

The TIMERl operator is used to retrieve or assign a value to the 8052AH's special function registers THl 
and TLl. This operator treats the byte registers THl and TLl as a 16-bit register pair. THl is the high 
byte and TLl is the low byte. MCS BASIC-52 uses THl and TLl to inq)lement the timings for the software 
serial port, the EPROM programming feature, and the PWM staten^nt. If the user does not use any of 
&ese features THl and TLl may be used in any manna* suitable to the particular ai^lkation. 

TIMER2 

The TIMER2 operator is used to retrieve or assign a value to the 8052AH's special function registers TH2 
and TL2. This operator treats the byte registers TH2 and TL2 as a 16-bit register pafa-. TH2 is the high 
byte and TL2 is the low byte. MCS BASlC-52 uses TH2 and TL2 to generate the baud rate for the serial 
port. If the user does not use TIMER2 to clock the serial port, TH2 and TL2 may be used in any manner 
suitable to the particular i^plicati<Hi. 
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XTAL 

The XTAL operator tells MCS BASIC-52 what frequency the system is operating at. The XTAL operator 
is used by MCS BASIC-52 to calculate the REAL TIME CLOCK reload value, the PROM programming 
timing, and the software serial port baud rate generation. The XTAL value is expressed in Hz. So, 

XTAL = 9000000 

would set the XTAL value to 9 MHz. 
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7.2 EXAMPLES OF MMWUiTlNG ^^AL FUMOm m^yiS r t 

Using the logical operators available in MCS BASIC-52, it is possible to write to or read from any byte 
of die special function registers tfaat MCS BASIC-S2 treats as a register pair: 

EXAMPLE: 



WRITING TO THE HIGH BYTE 

>TIMERO = (TIMERO .AND. OOFFH)+ INT ( 256» ( USER BYTE)) 



EXAMPLE: 



WRITING TO THE LOW BYTE 

>TIMERO » (TIMERO . AND. OFFOOH) + (USER BYTE) 



EXAMPLE: 



READING HIGH BYTE 
>PHO. INT(TIMeR0/aS6) 



EXAMPLE: 



READING LOU BYTE 

>PHO. TIMERO . AND. OFFH 



TIMERl can function as the baud rate generator for MCS BASIC-52. To assign TIMERl as the baud rate 
gen«-ator, the following instructi«M laMst be ^ecuted: 



>TMiJD « 32 - TIMERl in «oto reload mode 

>TinERl > 296*(256-(6S536-RCAP2)/12> - load TIMERl 
>T2C0N > - .use TIMERl as baud rate gen 



This sequence of instructions can be executed in either the direct mode or as part of a program. When 
TIMERl is used as the baud rate generator, TIMER2 can be used in anyway suitable to the application. 
The PROG, FPROG, LIST#, PRINT# and PWM commands/statements cannot be used when TIMERl 
functions as the baud rate generator for the MCS BASIC-52 device. Certain crystals may not be able to 
use TIMERl as the baud rate generator, especially at high (above 2400) baud rates. 
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7.3 SYSTEM CONTROL VALUES 

The SYSTEM CONTROL VALUES determine or reveal how memory is allocated by MCS BASIC-52. 
MTOP 

After reset, MCS BASIC-52 sizes the external memory and assigns the last valid memory address to the 
SYSTEM CONTROL VALUE, MTOP. MCS BASIC-52 will not use any external RAM memory beyond 
the value assigned to MTOP. If the user wishes to allocate some external memory for an assembly language 
routine the LET statement can be used (e.g. MTOP = USER ADDRESS). If the user assigns a value to 
MTOP that is greater than the last valid memory address, a MEMORY ALLOCATION ERROR will be 
generated. 

EXAMPLES: 



>PRINT MTOP 
2047 

>MT0P=2000 

SPRINT MTOP 
2Q00 



LEN 

The SYSTEM CONTROL VALUE, LEN, tells the user how many bytes of memory the current selected 
program occupies. Obviously, LEN c^uiot be assigned a value, it can only be read. A NULL program 
(i.e. no ppogiam) wiU return a LEN of 1 . The I r^iresents the end of program file charact^. 

FREE 

The SYSTEM CONTROL VALUE, FREE, teUs the user how many bytes of RAM memory are available 
to fee user. When the current selected is in RAM memory, the following relationship will always hold 
true. 

FREE = MTOP - LEN - 511 

NOTE: Unlike some BASICS , MCS BASIC-52 does not require any ' 'dummy' ' arguments for the SYSTEM 
CONraOL VALUE?. 



CHAPTER 8 

Error Messages, Bells, Whistles, and Anomalies 



8.1 ERROR MESSAGES 

MCS BASIC-52 has a relatively sophisticated ERROR processor. When BASIC is in the RUN mode the 
generalized form of the ERROR message is as follows: 



ERROR: XXX - IN LINE YYY 

YYY BASIC STATEMENT 
-X 

! 



Where XXX is the ERROR TYPE and YYY is the line number of the program in which the error occurred. 
A specific example is: 



ERROR: BAD SYNTAX - IN LINE 10 

10 PRINT 34»21» 
X 



The X signifies !q>proximately where the ERROR occurred in the line number. The specific location of 

the X may be off by one or two characters or expressions depending on the type of error and where the 
error occurred in the program. If an ERROR occurs in the COMMAND MODE only the ERROR TYPE 
will be printed out NOT the Line number. This makes sense, because there are no line numbers in the 
COMMAND MODE. The ERROR TYPES are as follows: 

BAD SYNTAX 

A BAD SYNTAX error means that either an invalid MCS BASIC-52 COMMAND, STATEMENT, or 
OPERATOR was entered and BASIC cannot process the entry. The user should check and make sure that 
everything was typed in correctly. In Version 1.1 of MCS BASIC-52 a BAD SYNTAX ^iJlOR.mj^ 
generated if the programmer attempts to use a reserved keyword as part of a variable. 

BAD ARGUMENT 

When the argument of an operator is not within the limits of the operator a BAD ARGUMENT l^ROR 
will be generated. For instance, DBY(257) would generate a BAD ARGUMENT ERROR because the 
argument for the DBY operator is limited to the range to 255. Similarly, XBY(5000H) = - 1 would 
generate a BAD ARGUMK^ ERROR because the value of the XBY operator is limited to the range 
to 255. 
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ARITH. UNDERFLOW 

If the result of an arithmetic operation exceeds the lower limit of an MCS BASIC-52 floating point number, 
an ARITH. UNDERFLOW ERROR will occur. The smallest floating point number in MCS BASIC-52 is 
± IE— 127. For instance, 1E-8CV1E+80 would cause an ARTIH. UNDERFLOW ERROR. 

ARITH. OVERFLOW 

If the result of an arithmetic operation exceeds the upper limit of an MCS BASIC-52 floating point number, 
an ARITH. OVERFLOW ERROR will occur. The largest floating point number m MCS BASIC-52 is 
± .99999999E-I- 127. For instance, lE+7§*ll-l-70 would cause an ARITH. OVERFLOW ERROR. 

DIVIDE BY ZERO 

A division by ZERO was attempted i.e. 12/0, will cause a DIVIDE BY ZERO ERROR. 
ILLEGAL DIRECT (VERSION 1.0 ONLY) 

Some statements, such as IF-THEN and DATA cannot be executed while the MCS BASIC-52 device is 
in the COMMAND MODE. If you attempt to execute one of these statements the message ERROR: 
ILLEGAL DIRECT will be printed to the console device. The ILLEGAL DIRECT ERROR is not trapped 
in Version 1.1 of MCS BASIC-52. ILLEGAL DIRECT ERRORS return a BAD SYNTAX ERROR in 
Version 1.1. 

LINE TOO LONG (VERSION 1.0 ONLY) 

If you type in a line that contains more than 73 characters the message ERROR: LINE TOO LONG will 
be printed to the console device. MCS BASIC-52's input buffer can only handle up to 73 characters. 

NOTE 

This error does not exist in Version 1.1. Instead the input buffer has been increased to 79 characters and 
MCS BASIC-52 will echo a bell character to the user traminal if too many characters are entered into the 
input buffer. 

NO DATA 

If a READ STATEMENT is executed and no DATA STATEMENT exists or all DATA has been read 
and a RESTORE instruction was not executed the message ERROR: NO DATA — IN LINE XXX will 
be printed to the console device. 
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CAN'T CONTINUE 

Program execution can be halted by either typing in a control-C to the console device or by executing a 
STOP STATEMENT. Normally, program execution can be resumed by typing in the CONT command. 
However, if the user edits the program after halting execution and then enters the CONT command, a 
CAN'T CONTINUE ERROR will be generated. A control-C must be typed during program execution or 
a STOP STATEMENT must be executed before the CONT command will work. 

PROGRAMMING 

If an error occurs while the MCS BASIC-52 device is programming an EPROM, a PROGRAMMING 

ERROR will be generated. An error encountered during programming destroys the EPROM FILE STRUC- 
TURE, so the user cannot save any more programs on that particular EPROM once a PROGRAMMING 
ERROR occurs. 

A-STACK 

An A-STACK (ARGUMENT STACK) error occurs when the argument stack pointer is forced "out of 
bounds." This can happen if the user overflows the argument stack by PUSHing too many expressions 
onto the stack, or by attempting to POP data off the stack when no data-is pm^. 

C-STACK 

A C-STACK (CONTROL STACK) error will occur if the confrol stack pointer is forced "out of bounds." 
158 bytes of external memory are allocated for the control stack, FOR — NEXT loops require 17 bytes 
of control stack DO — UNTIL, DO — WHILE, and GOSUB require 3 bytes of control stack. This means 
that 9 nested FOR — NEXT loops is the maximum that MCS BASIC-52 can handle because 9 times 17 
equals 153. If the user attempts to use more control stack than is available in MCS BASIC-52 a C-STACK 
error will be generated. In addition, C-STACK errors will occur if a RETURN is executed before a GOSUB, 
a WHILE or UNTIL before a DO, or a NEXT before a FOR. 
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l-STACK 

An I-STACK (INTERNAL STACK) error occurs when MCS BASIC-52 does not have enough stack space 
to evaluate an expression. Normally, l-STACK errors will not occur unless insufficient memory has been 
allocated to the 8052AH's stack pointer. Detail$ of how to allocate meoiory to the stack pointer are coveised 
in the ASSEMBLY LANGUAGE LINKAGE section of Ms manual. 

ARRAY SIZE 

If an array is dimensioned by a DIM statement and then you attempt to access a variable that is outside 
of the dimensioned bounds, an ARRAY StIZE enor wiU be g^n^ted. 

EXAMPLE: 



>DIM AdO) 
:>PRINT A<11> 

SIROR: ARRAY SIZE 
REA&Y 



MEMORY ALLOCATION 

MEMORY ALLOCATION ERRORS are generated when user attempts to access STRINGS that are 
"outside" the defined string limits. Additionally, if the SYSTEM CONTROL VALUE, MTOP is assigned 
a value that does not contain any RAM memory,, a MEMORY A1--LOCATION ERROR will occur. 
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8.2 DISABLING CONTROL-C 



In some applications, it may be desirable or even a requirement that program execution not accidentally 
be halted. Under "normal" operation the execution of any MCS BASIC-52 program can be terminated 
by typing a "control-C" on the console device. However, it is possible to disable the "control-C" break 
function in MCS BASIC-52. This is accomplished by setting BIT 48 (30H) to a one. BIT 48 is located in 
internal memory location 38.0 (26.0H). This BIT may be set by executing the following statement in an 
MCS BASIC-52 program: ' •■ 



DBY(38) = DBY(38).OR.01H 



Once this BIT is set to a one, the control-C break function, for both LIST and RUN operatioas will be 
disabled. The user has the option to create a custom break character or string of characters by using the 
GET operator. The foQowing is an example of how to implement a custom break character: 



EXAMPLE: 



>10 STRINO 100.10; A>1: REM INITIALIZE STRINGS 
>20 «<1) - "BREAK" : REM "BREAK" IS THE PASSWORD 
>30 0BY(38)-0BY(3a). OR. 1 : REM DISABLE CONTROL-C 
>40 FOR I-l TO 1000 : REM DUMMY LOOP 
>50 J-SIN(I) 

>60 K-OET : IF KOO THEW 100 ELSE NEXT I 
>70 END 

MOO IF K-ASC(«(1), A) THEN A-A-^1 ELSE A>t 

>110 REM TEST FOR MATCH 

>120 IF A-1 THEN NEXT . I 

>130 IF A<-6 THEN 200 ELSE NEXT I 

>140 END 

>200 PRINT "BREAK" 

>210 DBY<3a)>>DBY<38). AND. OPEH : REM ENABLE 6iDNTR0L-G 



In this example, typing the word BJREAK will stop program execution. In other words, BREAK is a 
password. 
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8.3 IMPLEMENTING "FAKE DMA" 

The MCS BASIC-52 device does not contain any hardware mechanism that supports Direct Memory Access 
(DMA). However, the DMA function is supported in software by MCS BASIC-52. During DMA operation 
MCS BASIC-52 guarantees that no exti^iial meioeiy access will be peiformed. To enable &e DMA function, 
the following must be performed: 

1) BIT 49, which is located in internal memory location 38. 1 (26. IH) must be set to a one. This can be 
accomplished in BASIC by using the statement — DBY(38) = DBY(38).OR.02H 

2) BIT and BIT 7 of the SPECIAL FUNCTION REGISTER, IE (Interrupt enable) must be set to a one. 
This can be accomplished in BASIC by using the statement — IE = IE.OR.81H 



After the three BITS mentioned above are set to a one, external interrupt zero (INTO) acts as a DMA input 
pin. INTO is pin 12 on the 8052AH. Whenever INTO is pulled low (to a logical zero state), the MCS 
BASIC-52 device will enter the DMA mode and no accesses will be made to external memory. To 
acknowledge that MCS BASIC-52 has entered the DMA mode, MCS BASIC-52 outputs a zero on pin 1 
(PI. 6). In essence, PORT 1.6 is the DMA ACK pin of die MCS BASIC-52 device. In most applications, 
this pin would be used to disable three-state buffers that would be placed on PORT2, PORTO, and the 
address latch of the MCS BASIC-52 system. After the user pulls the INTO pin high, MCS BASIC-52 will 
output a one on PI. 6 and normal program execution will continue. During this "fake DMA" cycle, the 
MCS BASIC-52 program does nothing except wait for the INTO pin to be pulled high. So, program 
executicm is halted. 

It should be noted that although this "fake DMA" operation does provide the same ftinctionality as a 
normal DMA hardware mechanism, it also takes substantially longer for the normal DMA REQUEST — 
DMA ACKNOWLEDGE cycle to be performed. That is because MCS BASIC-52 uses interrupts to 
implement the DMA operation, instead of dedicated hardware. As a general rule, cycle stealing DMA is 
not an option with MCS BASIC-52's "fake" DMA. Only "burst mode" DMA cycles can be implemented 
without a significant time penalty. When "fake DMA" is implemented, the user must provide three-state 
buffos on the PORT2, PORTO, and the address latch of the MCS BASIC-52 system. 
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8.4 RUN TRAP OPTION (Version 1.1 Only) 

Version 1.1 of MCS BASIC-52 permits the user to trap the interpreter in the RUN MODE. This option 
is evoked by putting a 34H (52D) in external data memory location 5EH (94D). After a 34H (52D) is 
placed in external data memory location 5EH (94D) the MCS BASIC-52 interpreter will be trapped in the 
RUN mode forever or until the contents of external data memory location is changed to something other 
than 34H (52D). If no program is present when a 34H (52D) is placed in location 5EH (94D), MCS 
BASIC-52 will print the READY message ftwever and it will be time to RESET the device. The RUN 
TRAP option can be employed with the other RESET options to permit the user to execute a program from 
RAM on a RESET or power-up condition when some type of battery back-up memcoy scheme is employed. 
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8.5 ANOMALIES 

Most dictionaries define an anomaly as a deviation from the normal or common order or as an irregularity. 
Anomalies to an extreme become ' 'BUGS" or something that is wrong with the program. Like all programs, 
MCS BASIC-52 contains some Momalies, hopefully, no bugs. The purpose of mentioning the known 
anomalies here is that it may save the programmer some time, should strange things happen during program 
execution. The known anomalies deal mainly with the way MCS BASIC-52 compacts ot tokenizes the 
BASIC program. The known anomalies and cautions are as follows: 

1) When using the variable H after a line number, make sure you put a space between the line number 
and the H, or else BASIC will assume that the line number is a HEX number. 

EXAMPLES: 



;>20H=10 (WRONG) 


;>20 H=10 (RIGHT) 


:>LIST 


>LIST 


32 '10 


20 H»10 



2) When using the variable 1 before an ELSE statement, make sure you put a space between the I and the 
ELSE statement, or else BASIC will assume that the IE portion of lELSE is the special function operator 
IE. 



EXAMPLES: 



>20 IF I>10 THEN PRINT lELSE 100 
>LIST 

20 IF 1>10 THEN PRINT lELSC 100 CUR0^<e> 



:>20 IF IMO THEN PRINT I ELSE 100 
:'LIST 

20 IF I>10 THEN PRINT I ELSE 100 (RIGHT) 



3) A Space character may not be placed inside the ASC( ) operator. In other words, a statement like 
PRINT ASC( ) will yield a BAD SYNTAX ERROR. Spaces may be placed in strings however, so 
a statement like LET ${1) = "HELLO, HOW ARE YOU*' will work properly. The reason ASC{ ) 
yields an error is because MCS BASIC-52 eliminates all spaces when a line is processed, so ASC| ) 
will be stored as ASC( ) and MCS BASIC-52 interprets this as an error. 
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CHAPTER 9 

Assembly Language Linkage 



9.1 OVERVIEW 

NOTE: This section assumes that the designer has an understanding of the architecture and assembly 
language of the MCS-51 Microcontroller family!!! 

MCS BASlC-52 contains a complete library of routines that can easily be accessed with assembly language 
CALL instructions. The advantage of using assembly language is that it offers a significant improvement 
in execution speed relative to interpreted BASIC. In order to successfully interface MCS BASIC-52 with 
an assembly language program, the software designer must be aware of a few simple facts. ^ 

READ THIS CAREFULLY!!! 

1. MCS BASIC-52 uses REGISTER BANKS 0, 1, and 2 (RBO, RBI, and RB2). REGISTER BANK 3 
(RB3) is never used except during a PGM statement. RB3 is designated the USER REGISTER BANK 
and the users can do whatever they want to with REGISTER BANK 3 (RB3) and MCS BASIC-52 will 
never alter the contents of this REGISTER BANK except during the execution of a PGM statement. 
The contents of REGISTER BANK 3 (RB3) can be changed by executing a DBY ([expr]) = [0 to 255] 
statement. Where the [expr] evaluates to a number between 24 (I8H) and 31 (IFH) inclusive. In 
addition, INTERNAL MEMORY LOCATIONS 32 (20H) and 33 (21H) are also NEVER used by MCS 
BASIC-S2. These two BIT and/or BYTE ^dress^le locations are specifically reserved fc^ a8send>ly 
language programs. _ 

2. MCS BASIC-52 uses REGISTER BANK (RBO) as the WORKING REGISTER FILE. Whenever 
assembly language is used to access MCS BASlC-52's routines, the WORKING REGISTER FILE, 
REGISTER BANK (RBO) MUST BE SELECTED! ! ! This means that the USER MUST MAKE SURE 
THAT REGISTER BANK (RBO) IS SELECTED BEFORE CALLING ANY OF MCS BASlC-52's 
ROUTINES. This is done simply by setting BITS 3 and 4 in the PSW equal to ZERO. If this is not 
done, MCS BASIC-52 will "KICK OUT" the USER and NO operation will be performed. When an 
ASSEMBLY LANGUAGE program is accessed by using the MCS BASIC-52's CALL instruction, 
REGISTER BANK (RBO) will always be selected. So unless the user selects REGISTER BANK 3 
(RB3) in assembly language, it is NOT NECESSARY to change the designated REGISTER BANK. 

3. ALWAYS ASSUME THAT MCS BASIC-52 DESTROYS THE CONTENTS OF THE WORKING 
REGISTER FILE AND THE DPTR, UNI^SS OTHERWISE STATED m ALLOWING DOCU- 
MENTATION. 

4. Certain routines in MCS BASIC-52 require that REGISTERS be initialized BEFORE the user CALLS 
that specific ROUTINE. These registers are ALWAYS in the WORKING REGISTER FILE, REGISTER 
BANK (RBO). 

5. Certain routines in MCS BASIC-52 return the result of an operation in a register or registers. The result 
registers are ALWAYS in the WORKING REGISTER FILE, REGISTER BANK 0, (RBO). 
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9.1 OVIRVIEW 

READ THIS CAREFULLY!!! 

6. MCS BASIC-52 loads the INTERNAL STACK POINTER (SPECIAL FUNCTION REGISTER- SP) 
with the value that is in INTERNAL MEMORY LOCATION 62 (3EH). MCS BASIC-52 initializes 
INTERNAL MEMORY LOCATION 62 (3EH) by writing a 77 (4DH) to this location after a hardware 
RESET. MCS BASIC-52 does NOT use any memory beyond 77 (4DH) for anything EXCEPT STACK 
SPACE. If the user wants to ALLOCATE some additional internal memory for their application, this 
is done by changing the contents of INTERNAL MEMORY LOCATION 62 (3EH) to a value that is 
GREATER than 77 (4DH). This wiU allocate the INTERNAL MEMORY LOCATIONS from 77 (4DH) 
to the value that is placed in INTERNAL MEMORY LOCATION 62 (3EH) to the user. As a guideline, 
it is a good idea to allow at least 48 (30H) bytes of stack space for MCS BASIC-52. The bad news 
about reducing the stack space is that it will reduce the ^iKHuit of nested parentheses that MCS BASIC-52 
can evaluate in an expression [expr]. This will either ame, a I-STACK ERROR or will cause a fatd 
CPU "crash." Use caution and DON'T allocate more memory than you need. 

EXAMPLE OF THE EFFECTS OF ALTERING THE STACK ALLOCATION: 





COMMENTS 




;>PRINT DBY(62) 
77 


AFTER RESET INTERNAL MEMORY LOCATION 62 
CONTAIMS A 77 




>PRINT (1*(2«(3))> 
6 


BASIC HAS NO PROBLEM EVALUATING 3 LEVELS 
OF NESTED PARENTHESIS 




:>DBY(62)=«230 
;>PRINT (HK2*<3))) 


NOW ALLOCATE 255-230 = 25 BYTES OF STACK 
SPACE TO BASIC, REMEMBER, THE STACK ON 
THE 8052AH GROWS "UP" 




ERROR; I-STACK 
READY 

:>DBY(62)=210 

;>PRINT (1*(2»(3))) 
6 


BASIC CANNOT EVALUATE THIS EXPRESSION 
BECAUSE IT DOES NOT HAVE ENOUGH STACK 
NOW ALLOCATE 255-210 = 45 BYTES OF STACK 
SPACE TO BASIC 
THE I-STACK ERROR GOES AWAY 





7. Throughout this section a 16-BIT REGISTER PAIR is designated-Rx:Ry, where Rx is the most sig- 
nificant byte wai % is least sigmfioint b^. 

EXAMPLE: 



R3: Rl - R3=^M3ST SiCNIFlCANT SYTEi RlsUEAST SIONIFICANT BYTE 
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9.2 GENERAL PURPOSE ROUTINES 

Accessing MCS BASIC-52 routines with assembly language is easy. The user just loads the ACCUMU- 
LATOR with a specific value and CALLS LOCATION 48 (30H). The value placed in the ACCUMULATOR 
determines what operation will be performed. Unless otherwise stated, the CONTENTS of the DPTR and 
REGISTER BANK (RBO) will ALWAYS be altered when calling these routines. The generalized fOTm 
for accessing MCS BASlC-52's routines is as follows: 

ANL PSW,#111(X)111B ; make sure 

RBO is 
selected 

MOV A,#OPBYTE ; load the 

instruction 

CAUL 30H ; execute the 

instruction 

The value of OPBYTE determines what operation will be performed. The following operations can be 
performed: 

OPBYTE « (CWH) RETURN TaCOMMAND MODE 

This instruction causes MCS BASIC-52 to enter the COMMAND MODE. Control of the CPU is handed 
back to the MCS BASIC-52 interpteteE.Mid BASIC will respond by oulputting a R^U3Y «id a PROMPT 
character (>). 

OPBYTE = 1 (01H) POP ARGUMENT STACK ANO PUT mUE IN R3:R1 

This instruction converts the value that is on the ARGUMENT STACK to a 16 BIT BINARY INTEGER 

and returns the BINARY INTEGER in registers R3 (high byte) and Rl (low byte) of REGISTER BANK 
(RBO). The ARGUMENT STACK gets popped after this instruction is executed. If the value on the 
ARGUMENT STACK cannot be represented by a 16-BIT BINARY NUMBER (i.e. it is NOT between 
and 65535 (OFFFFH) inclusive), BASIC WILL TRAP THE ERROR and print a BAD ARGUMENT 
ERROR MESSAGE. The BINARY VALUE returned is TRUNCATED, NOT ROUNDED. 

EXAMPLE: 





10 


PUSH 


260 






20 


CALL 


5000H 




ASSEMBLY LANGUAGE PROGRAM - 


ORG 


5000H 








MOV 


A. »0 


IH ; load opbyte 






CALL 


30H ; RBO still s 


elected 




_ A - 

f at 


this 


point R3 (of RBO) 


= OIH 




I an 


d Rl 


(of RBO) - 04H 






i so 


. R3: 


Rl = 260> uihich was 


th« value 




i th 


at iita 


s placsd on the ARGUMENT STACK 



9.2 GENERAL PURPOSE ROUTtNES 

COMMENTS ON THE NEXT TWO INSTRUCTIONS: 

The next two instructions permit the user to transfer floating point numbers between an assembly language 
program and MCS BASIC-52. The user provides the address where a floating point number is stored or 
will be stored in a 16-bit REGISTER PAIR. Depending on the operation requested, the floating point 
numbers are either PUSHED ON or POPPED OFF MCS BASIC-52's ARGUMENT STACK. This in- 
struction permits the user to keep track of variables in assembly language and bypass the relatively slow 
procedure BASIC must follow. 

As mentioned earher, when a floating point number is PUSHED onto the ARGUMENT STACK, the 
ARGUMENT STACK POINTER is decremented by a count of 6. This is because a floating point number 
requires 6 bytes of RAM storage. Although it may seem confusing to the novice, the LAST value placed 
on the ARGUMENT STACK is referred to as the value on the TOP of the ARGUMENT STACK, even 
though it is on the BOTTOM of the STACK relative to the sequential numbering of memory addresses. 
No one Imows why this is m. 

The ARGUMENT STACK resides in EXTERNAL RAM MEMORY LOCATIONS 301 (12DH) through 
510 (IFEH). The lower BYTE of the ARGUMENT STACK POINTER resides in INTERNAL MEMORY 
LOCATION 9 (09H). MCS BASIC-52 always assumes that the upper BYTE (higher order address) of the 
ARGUMH^ STACK POINTHl is 1 (OIH). The software designer can use this information, along wifli 
the next two instructions to porform op^ti^s like copying the stad£. 

OPBYTE = 2 (02H) PUSH THE FLOATING POINT NUMBER ADDRESSED BY REGISTER 
PAIR R2:R0 ONTO THE ARGUMENT STACK. 

R2 and RO (in REGISTER BANK 0, RBO) contain the ADDRESS (R2 = high byte, RO = low of 
the location where the floating point number is stored. After this instruction is executed the floating point 
number that the REGISTER PAIR R2:R0 points to is PUSHED onto the TOP of the ARGUMENT STACK. 
Tlie ARGUMENT STACK POINTER automatically gets DECREMENTED, by a count of 6, when the 
value is placed on the stack. A floating point number in MCS BASIC-52 requires 6 BYTES of RAM 
storage. The register Pair R2:R0 points to the MOST SIGNIFICANT BYTE of the floating point number 
and is DECREMENTED BY 6 after the CALL instruction is executed. So, if R2:R0 = 7F18H before this 
instruction was e^cecuted, it would equal 7F12H aflrar Ms iaskadkm was executed. 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 3 (03H) POP THE ARGUMENT STACK AND S*m tm PLJOATim POm 
NUMBER IN THE LOCATION ADDRESSED BY R3:R1. 

The TOP of the ARGUMENT STACK is moved to the location pointed to by the REGISTER PAIR 
R3:R1(R3 = high byte, Rl = low byte, in REGISTER BANK 0, RBO). The ARGUMENT STACK 
POINTER is automatically INCREMmfFED BY 6. Just as in the {Hevious PUSH insttuctioii, die Wm- 
ISTER PAIR R3:R1 points to the MOST SIGNIFICANT BYTE of die floating point number and is 
DECREMENTED BY 6 after the CALL instruction is executed. 

EXAMPLE OF USER PUSH AND POP: 



BASIC PRQGRAri: 


>5 


REM PUT 100 AND 200 ON 


THE ARGUMENT STACK 




>10 


PUSH 100,200 






>15 


REM CALL THE USER ROUTINE TO SAVE NUMBERS 




>20 


CALL 5000H 






>25 


REM CLEAR THE STACK 






>30 


CLEARS 






>35 


REM USE ASM TO P\iT NUMIERS BACK ON STACK 




>40 


CALL 5010H 






>50 


POP A, B 






>60 


PRINT A. B 






>RUN 






100 


200 






READY 




ASM PROeRAM: 


ORG 


5000H 






MOV 


R3, #HIGH USER_SAVE 


LOAD POINTERS TO WHERE 




MOV 


R 1 , #Laui USER_SAVE 


NUMBERS WILL BE SAVED. 




MOV 


A, #03H 


LOAD OPBYTE 




CALL 


30H 


SAVE ONE NUMBER 




MOV 


A. 4»03H 


LOAD OPBYTE AGAIN 




CALL 


30H 


SAVE ANOTHER NUMBER 




RET 




BACK TO BASIC 




ORG 


501 OH 






MOV 


R2, »HIGH USER_SAVE 


LOAD ADDRESS WHERE 




MOV 


RO, #LOW USER_SAVE 


NUMBERS ARE STORED 




MOV 


A, »02H ~ 


LOAD OPBYTE 




CALL 


30H 


PUT ONE NUMBER ON STACK 




MOV 


A, #02H 


LOAD OPBYTE 




CALL 


30H 


NEXT NUMBER ON STACK 




RET 




BACK TO BASIC 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 4 (04H) PROGRAM A PROM USING R3:R1 AS THE SOURCE ADDRESS 
POINTER, R2:R0 AS THE DESTINATION (PROM) ADDRESS POINTER, AND R7:R6 AS THE 
BYTE COUNTER. 

This instruction assumes that the DATA to be programmed into a PROM is stored in external memory 
and that the REGISTER PAK R3:R1 (in RBO) contains the address of this external memory. REGISTER 
PAIR R7:R6 contains the total number of bytes that are to be pxi>grammed. The PROM is programmed 
sequentially and everytime a byte is programmed the REGISTER PAIR R7:R6 is decremented and the 
REGISTER PAIRS R3:R1 and R2:R0 are incremented. Programming continues until R7:R6 equals ZERO. 
The REGISTER PAIR R2:R0 must be initialized with the desired ADDRESS of the EPROM to be 
programmed MINUS 1 . This may sound strange, but that is the way it works. So, if you wanted to program 
an EPROM starting at address 9000H, with the data stored in address ODOOH and you wanted to program 
500 BYTES, then the registers would be set up as follows: R2:R0 = 8FFFH, R3:R1 = ODOOH, and 
R7:R6 = 01F4H (500 decimal). You would then put a 4 (04H) in the ACC and CALL location 30H. 

NOTE: In Version 1.0, if an ERROR OCCURS DURING PROGRAMMING, MCS BASIC-52 WILL 
TRAP THE ERROR AND ENTER THE COMMAND MODE. The user cannot handle errors that occur 
diuing the EPROM progranuning operation!!!! 

In Version 1.1, programming errors will only be trapped if ttie MCS BASIC-52 device is in the COMMAMD 
MODE. If the MCS BASIC-52 device is in the run mode, control will be passed back to the user. The 
user must then examine registers R6 and R7. If R6 = R7 = 0, then the programming operation was 
successfully completed, if these registers do not equal zero then registers R2:R0 contain the address of the 
EPROM location that failed to program. This feature in Version 1 . 1 permits the user to program EPROMS 
in embedded applications and manage errors, should they occur in the programming process, without 
trapping to the command mode. 

In addition to setting up the pointers previously described, the user must also initialize the INTERNAL 
MEMORY locations that control flie width of the jHOgramming pulse. This gives the user complete control 

over this critical prom programming parameter. The internal memory locations that must be initialized 
with this information are 64 (40H) and 65 (41H). These locations are treated as a 16 bit register pair with 
location 64 (40H) designated as the most significant byte and location 65 (41H) as the least significant 
byte. Locations 64 (40H) and 65 (41H) are loaded into THl (TIMER 1 high byte) and TLl (TIMER 1 
low byte) respectively. The width of the programming pulse, in microseconds is determined by the following 
equation: 

WIDTH = (65536 — 256*DBY(64) + DB Y(65))*12/XTAL microseconds 
conversely; 

DBY(64):DBY(fi5) « 1I1DTH*XTAL/12 

The proper values for the "normal" 50 millisecond programming algorithm and the 1 millisecond 
"INTELligent" algorithm are calculated and stored by MCS BASIC-52 in external memory locations 
296:297 (128H:129H) and 298:299 (12AH:12BH) respectively. If the user wants to use the pre-calculated 
values the statements DB Y(64) = XBY(296) and DB Y(65) = XBY(297) may be used to initialize the prom 
programming width for the normal algorithm and the statements DBY(64) = XBY(298) and 
DBY(65) = XBY(299) can be used to initialize for the INTELligent algorithm. 
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9.2 GENERAL PURPOSE ROUTINES 

To select the "INTELLIGENT" EPROM PROGRAMMING algorithm the directly addressable BIT 51 
(33H) MUST be set to 1 before the EPROM PROGRAMMING routine is called. The "STANDARD" 
50 ms EPROM PROGRAMMING algorithm is selected by CLEARING BIT 51 (33H) (i.e. BtT 51 
before calling the EPROM PROGRAMMING routine. The directly addressable BIT 51 is located in internal 
memory location 38.3 (26 3H) (BIT 3 of BYTE 38 (26H) in internal memory). This BIT can be SET or 
CLEARED by the BASIC STATEMENTS DBY(38) = DBY(38).OR.08H to SET m€ 
DBY(38) = DBY(38).AND.0F7H to CLEAR. Of course, the user can set or clear this bit in assembly 
language with a SETB 51 or CLR 51 instruction. 

The user must also turn on the EPROM PROGRAMMING voltage BEFORE calling the EPROM PRO- 
GRAMMING routine. This is done by CLEARING BIT PI. 5, the fifth BIT on PORT 1. This too can be 
dam ia BASIC with a PORTl = PORTI.AND.0DFH instruction or in assembly language wifli a CLR P*.S 
instruction. The user must also set this bit when the PROM PROGRAMMING procedure is complete. 

This instructicm assumes that the hardware surrounding the MCS BASIC-52 device is tibte same as ^ 
suggestitms in tiie EPROM PROGRAMMING chapter of this manual. 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 5 (05H) iNP^ A mmm-m&im/mms and store in the basic 

INPUT BUFFER. 

This instruction inputs a line of text from the console device and saves the information in the MCS BASIC- 
52's input buffer. MCS BASIC-52's input buffer begins at EXTERNAL MEMORY LOCATION 7 (0007H). 
All of the line editing features available in MCS BASIC-52 are implemented in this instruction. If a control- 
C is typed during the input process, MCS BASIG-52-will trap back into the command mode. A carriage 
return (cr) terminates the input procedure. 

OPBYTE = 6 (06H) OUTPUT THE STRING OF CHARACTERS POINTED TO BY THE 
REGISTER PAIR R3:R1 TO THE CONSOLE DEVICE. 

This instruction is used to OUTPUT a string of characters to the console device. R3:R1 contains the initial 
address of this string. The string can either be stored in PROGRAM MEMORY or EXTERNAL DATA 
MEMORY. If BIT 52 (34H) (which is BIT 4 of internal RAM location 38 (26H)) is set, the output will 
be from PROGRAM MEMORY. If BIT 52 is cleared, the output will be from EXTERNAL DATA 
MEMORY. The DATA stored in MEMORY is sent out to the console device one byte at a time and the 
memory pointer is incremented. The output is stopped when a termination character is read. terminati^ 
character for PROGRAM MEMORY and EXTERNAL DATA MEMORY are different. The termination 
character for EXTERNAL DATA MEMORY is a (cr) ODH. The termination character for PROGRAM 
MEMORY is a " or 22H. 

OPBYTE = 7 (07H) OUTPUT A CARRIAGE RETURN-LINE FEED SEQUENCE TO THE 
CONSOLE DEVICE. 

Enough said. 

OPBYTE = 128 (80H) OUTPUT TH^ CHARACTER IN R5 (REOISTER BANK 0) TO THE 
CONSOLE DEVICE. 

This routine takes the character that is in R5 (register bank 0) and directs it to the console device. Any 
console device may be selected (i.e. UO or Ul or the software serial port). 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 144 (90H) OUTPUT THE ttUMBE^ 0I« THE TO? OF i|fl@UMENT STACK TO 
THE CONSOLE DEVICE. 

The floating point number that is on the top of the argument stack is outputted to the console device. The 
FORMAT is determined by the USING statement. The argument stack is POPPED after the output operation. 

OPBYTE = 154 (9AH) THE 16 BIT NUMBER REFR^ENTED RY REGISTER PAIR R2:R0f8 
PUSHED ON THE ARGUMENT STACK. 

This instruction converts the 16 bit register pair R2:R0 to a floating point number and pushes this number 
onto the argument stack. This instruction is the converse of the OPBYTE = 1 instruction. 



9.3 UNARY OPERATORS 

The next group of instructions perform an operation on the number that is on the TOP of the ARGUMENT 
STACK. If the TOP of the ARGUMENT STACK is represented by the symbol [TOS], then the following 
instructions would take the general fcam: i k faiu - ' 1 

[TOS] < OP [TOS] 

Where OP is 0ne of iim §^^immi$ cpenoors: ■ . ■ ^'nt < « i w ;w 

! • 1 '.zfijs) a,. 

OPBYTE = 24 (18H) — ABSOLUTE VALUE 

[TOS] < ABS([TOS]). Hie {TOSJi m usg^usei Isy the absohite POS); t- .u^ j 

' • ■ 'i- !! ■' MiiC'Tl) r • 11 

OPBYTE = 25 (19H) — INTEGER 

[TOS] < INT([TOS]). The [TOS] is replaced by the integsar portion of [TOS]. 
OPBYTE = 26 (1AH) — SIGN 

[TOS] < SGN([TOS]). If [TOS] > then [TOS] = 1, if [TOS] = then [TOS] = 0, and if [TOS] < 
[TOS] = -1. 

C';-; I 1 : . - ,1. - .i\}s>jrr •■■ ■ . 

©PBYTE = 27 (1BH)-* ^IIE'S COMPLEMENT 

[TOS] < NOT(rrOS]). [TOS] must be a valid integer. 

OPBYTE = 28(1CH)^e^l|li#f»ERATOR 

rroS] < COS([TOS]). mmt be between ±200000. 

OPBYTE = 29 (tDH) — TANGENT OPERATOR 

[TOS] < TAN([TOS]). [TOS] must be between ±200000 and [TOS] cannot equal PI/2, 3*PI/2, 5*Py2, 
. . . . (2*N + l)*PI/2. A..^ . . I. 
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9.3 UNARY OPERATORS 

OPBYTE = 30 (1EH) — SINE OPERATOR 

[TOS] < SIN([TOS]). [TOS] must be betwc«i ±200000. 

OPBYTE = 31 (1FH) — SQUARE ROOT 

[TOS] < SQR ([TOS]). [TOS] must be >= 0. 



OPBYTE = 32 (20H) — CBY.#liiBATi^' 

[TOS] < CBY ([TOS]). [TOS] must be a valid integer. 

OPBYTE = 33 (21 H) — E TO THE [TOS] OPERATOR 

[TOS] < e(2.7182818)**[TOS]. e is raised to the [TOS] power. 

OPBYTE = 34 (22H) — ATN OPERATOR 

[TOS] < ATN([TOS]). Arctangent, the value returned is between ± PI/2 

OPBYTE = 35 (23H) — LOG OPERATOR (natural LOG) 

[TOS] < LOG([TOS]) — [TOS] mm be > 0. 

OPBYTE = 36 (24H) — DBY OPERATOR 

[TOS] < DBY([TOS]). [TOS] mu» If: teetwerai and 255 mclusive. 

OPBYTE = 37 (25H) — XBY OPERATOR 

rrail < 3CBY([T0S]). [TOS] must be a valid integer. 



int^ MCS®BASIC'52 

i.4 SPECIAL 0PlMKrORt O W 

The next group of instructions place a value on the stack. The value placed on the stack is as follows: 

OPBVTE = 38 (26H) — PI 

[TOS] = PI. PI (3.1415926) is placed on the [TOS]. 

OPBYTE = 39 (M> — mm 

[TOS] = RND. A random number is placed on the [TOS J. - i 

OPBYTE = 40 (W @ET 

[TOS] = GET. The value of the SPECIAL FUNCTION OPERATOR, GET is put on the [TOS]. ' "> 
OPBYTE = 41 — FREE 

[TOS] = FREE. TM' valm of SYSTm CONTROL VALUE, FREE is put on the [TOS] . 1 
OPBYTE = 42 (2M) — Mm 

[TOS] = LEN. The valii« «rito SYSTEM CONTROL VALUE, UiN is pm ' 
OPBYTE = 43 (2BW) — XTAU 

[TOS] = XTAL. Hi vA«l **e SPHIIAL FUMCllON OPmAlOR, JTTAL put m ^ [roS^' 
OPBYTE = 44 (2GH) — MTOP 

tmm = MTOP. Tte vsHm -^me SYSTEM. COWmOL VALUE, Mt» is :p«il«*@ [TOS]. 
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9.4 SPECIAL OPERATORS Jr 
OPBYTE = 45 (2DH) — TIME 

[TOS] = mfE. TTie value of tie iWCIAL FUNCTION OPERATOR, TIME is put cm the [TOS]. 
OPBYTE = 46 (2EH) — IE 

[TC®1 » IE. Tlie value of &e B n^pte M put on the [TOS]. 
OPBYTE = 47 (2FH) — IP 

[TOS] = IP. The value of the JP regista- is put oti flie [TOS]. 
OPBYTE = 48 (30H) — TIMERO 

[TOS] = TIMERO. The value of TftdQERO (THO:TLO) is put on the [TOS]. 
OPBYTE = 49 (31 H) — TIMER1 

[TOS] = TIMERl. The value of TIMERl (THI:TL1) is put on the [TOS]. 

'A 

OPBYTE = 50 (32H) — TIMER2 

[TOS] = TIMER2. The value of TIMER2 (TH2:TL2) is put on the [TOS]. 
OPBYTE = 51 (33H) — T2C0N 

[TOS] = T2CON. The value of the T2CON register is put on the [TOS]. 

OPttVH « 52 (34H) — TCON > > 

[TOS] = ICON. The value of the ICON register is put on the [TOS]. 
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9.4 SPECIAL OPERATORS 
OPBYTE = 53 (35H) — TMOD 

fr©S] = TMOD. The value of ttie TMOD register is put on Uie [TOS]. 
OPBYTE = 54 (36H) — RCAP2 

[TOS] = RCAP2. The value of the RCAP2 registers (RCAP2H:RCAP2L) is put on the [TOS]. 

OPBYTE = 55 (37H) — P0RT1 

= PORTl. The v^_|rihe POUTl (PI) pins is placKi on the [TOS]. 

■WIT' tii \ ■ 

OPBYTE = 56 (38H) — PCON 

[TOS] = PCON. The valwg itf ig iPCON register is put on die [TOPJ^^ 

1-1 4 to ■■ 
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9.5 DUAL OPERAND OPERATORS 



The next group of instructions assume that TWO values are on the ARGUMENT STACK. If number on 
the TOP of the ARGUMENT STACK is represented by the symbol [TOS] and the number NEXT to TOP 
of the ARGUMENT STACK is represented by the symbol [NxTOS] and the ARGUMENT STACK 
POINTER is represented by the symbol AGSP, then the following instructions would take the general 
fcHm: 

TEMPI = [TOS] ■( 
TEMP2 = [NxTOS] 
AGSP < AGSP + 6 
RESULT = TEMP2 OP TEMPI 
[TOS] = RESULT 

Where OP is one of the following operators to be described. NOTE that the group of instructions ALWAYS 
POP the ARGUMENT STACK &m MjQATING POINT NUMBER SEE (i.e. 6 BYTES). 

ERRORS can be handled in two different ways with the ADD, SUBTRACT, MULTIPLY, and DIVIDE 
routines. One option is to let MCS BASIC-52 trap ERRORS, should they occur during the operation. With 
this option MCS BASIC-52 will print the appropriate error message to the console device. The other option 
passes a STATUS CODE to the user. After the operation the Accumulator contains the status code 
infcHmation. The Status infonnatxon i»- as follows: 



ACC.O — ARITHMETIC UNDERFLOW 

ACC.l — ARITHMETIC OVERFLOW 

ACC.2 — RESULT WAS ZERO (not an error, just a condition) 
ACC.3 — DIVIDE BY ZERO 
ACC.4 — NOT USED, ZERO RETURNED 
ACC.5 — NOT USED, ZERO RETURNED 
ACC.6 — NOT USED, ZERO RETURNED 
— NOT USED, ZEm llMKNED 



If an ARTTH. OVERFLOW or a DIVTOE BY ZERO ERROR occurs and the user is handling the error 

condition, the floating point processor will return a result of ± 99999999E-I- 127 to the argument stack. 
The user can do what they want to with this result (i.e. use it or waste it). An ARITH. UNDERFLOW 
ERKliCW return to the aiganm$ iMk a result of (z^). 
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DUAL OPmVi» ORATORS \) nAt^e^lO i 

MCS BASlC-52 can perf«in the following DUAL OPERAND OPERATIONS: ''^ 



OPBYTE = 9 (09H) EXPONENTIATION — The [NxTOS] value is raised to teffCiiil^er. RESlflLf 
= [NxTOSl ** [TOSJ. NOTE — [JOS] MUST BE LESS THAN 256. 



OPBYTE = 10 (OAH) MULTIPUY < 

RESULT = [NxTOS] * [TOS]. If an ERROR occurs during this operation (i.e. ARITH. OVERFLOW 
or UNDERFLOW) MCS BASIC-52 will tra^p the ©ror and print die &S(xc message to the console device. 

OPBYTE = 136 (88H) MULTIPLY r ^ , , 

RESULT = [NxTOS] * [TOS]. If an error occurs during this operation, the status byte previously discussed 
win be returned to ^ usiM^. 



immFTE 8 11 (oati) mmf^' 

RESULT = [NxTOS] + pf®Sl. MJK handles otots. 

Yf - iflO^ r. (Hff')3r 

OPBYTE = 130 (03H) JM)D 

RESULT = [NxTC^J + ffW}. Wiea- handles errors. 

OPBYTE = 12 (OCH) DIVIDE 

RESULT = [NxTOS] / [TC^J. BJWe taidles errors. 

..-4 «iO • 

OPBYTE = 138 (BAH) DIVIDE 

RESULT = [NxTOS] / [TOS]. lOset handles ettOTS. 

OPBYTE = 13 (ODH) SUBTRACT 

RESULT = [NxTC«] - [TOS]. BASIC handles errras. 



II© 



iyi(^«BASI&€2 



9.5 DUAL OPERAND OPERATORS 

OPBYTE = 132 (84H) SUBTRACT 

RESULT = [NxTOS] - [TOS]. User handles errors. 

OPBYTE = 14 (OEH) EXCLUSIVE OR 

RESULT = [NxTOS] XOR [TOS], both values must be GREATER THAfiJ (Ml.EQUAL TO 23ERO and 
LESS THAN OR EQUAL TO 65535 (OFFFFH). 

OPBYTE = 15 (OFH) LOGICAL AND 

RESULT = [NxTOS] and [TOS], both values must be GREATER THAN OR EQUAL TO ZERO and 
LESS THAN OR EQUAL TO 65535 (OFFFFH). 

OPBYTE = 16 (10H) LOGICAL OR 

RESULT = [NxTOS] OR [TOS], both values must be GREATER THAH OM HJUAL TO mM3 «tid 
LESS THAN OR EQUAL TO 65535 (OFFFFH). 

OPBYTE = 18 (12H) TEST FOR EQUALITY 

IF [NxTOS] = [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 

OPBYTE = 19 (13H) TEST FOR GREATER THAN OR EQUAL 

IF [NxTOS] >= [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 

OPBYTE = 20 (14H) TEST FOR U^S THAN OR EQUAL 

IF [NxTOS] <= [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 
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9.5 DUAL OPERAN&^ERATORS mCV 
OPBYTE = 21 (15H) TEST FOR NOT EQUAL 

effij^imi <> {TOS] thM|r|Win.T » ^35 im?¥¥Bm, elmmS^iMB «k»> 
OPBYTE = 22 (16H) TEST FOR LESS THAN 

IF [NxTOS] < [TOS] then, RESULT = 65535 (OFFFFH), dse RESULT = 0. 

OPBYTE = 23 (17H) TEST FOR GREATER THAN 

IF [NxTOS] > [TOS] thai, 1«WIJ"»«.JIS5535 (OFHTH), else KmjLT-s= 0. 

ti . 



r ve 



it:' 



• m ihn r. 
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9.6 ADDED LINK ROUTINES TO VERSION 1.1 

Version 1 . 1 of MCS BASIC-52 contains a number of useful assembly language link routines that were 
not available in Vo^ion 1 .0. Most of these routines woe designed to be used in conjunction with the new 
Command/Statement ej^nsions Hiat ase de$enJbed in Chwp6Br 11 of Ms mjtnad. The iadd^ Ink mfiiiS 
are as follows: 

OPBYTE = 57 (39H) EVALUATE AN EXPRESSION WITHIN THE BASIC TEXT STRING AND 
PLACE THE RESULT ON THE ARGUMENT STACK 

This routine permits the user to evaluate a BASIC expression [expr] containing variables, operators and 
constants. The result of the evaluated expression is placed on the floating point argument stack. This 
ti^ user evaluate expressions in "customized" statements and commands. An example of use of iis 
OPBYTE is given at tiie end of this sectioa. 

OPBYTE = 58 (3AH) PERFORM CRYSTAL DEPENDENT CALCULATIONS WITH THE 
VALUE THAT IS ON THE ARGUMENT STACK 

This routine is provided mainly to let the user write an assembly language RESET routine and perform all 

of the crystal dependent calculations that are required by MCS BASIC-52. An example of a custondzed 
RESET routine that uses this OPBYTE is presented in Chapter 1 1 of this manual. 

OPBYTE = 63 (3FH) GET A CHARACTER OUT OF THE BASIC TEXT STRING 

This routine permits the user to "pick" a character out of tbs BASIC program. For instance, in BASIC 
the user could have the following: 

10 CALL lOOOH A 

If the user executed the following in assembly language at lOOOH: 

MOV A, #63 
LCALL 30H 

The character A would be returned in the accumulator. The Basic text pointer is located in location 8 (8H) 
(low byte) and 10 (OAH) (high byte) of the internal ram on the MCS BASIC-52 device. If the user were 
to implement the above function, the basic text pointer must be advanced to the carriage return at the end 
of the statement before returning back to Basic. Failure to do this will cause a BAD SYNTAX ERROR 
when the user returns back to Basic. The following OPBYTE can be used to advance the Basic Text 
pointer. 
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9.6 ADDED LINK ROUTINES TO VERSION 1.1 • 

OPBYTE = 64 (40H) GET CHARACTER, THEN INCREMENT TEXT POINTER 

This OPBYTE does the same thing as the previous one described, except that the BASIC text pointer is 
INCREMENTED AFTER the character is read. An example of this OPBYTE is presented at the end of 
this section. 

OPBYTE = 65 (41 H) INPUT A CHARACTER FROM THE CONSOLE DEVICE, PUT IT IN 
THE ACCUMULATOR, THEN RETURN 

This OPBYTE permits the user to input characters from MCS BASIC;52's console input routine. The 
character is placed in the accumulator upon return. " v. " > 

OPBYTE = 66 (42H) ENTER THE RUN MODE 

This OPBYTE permits the user to start the execution of an MCS BASIC-52 program from assembly 
language. The user need only insure that locations 19 (13H) and 20 (14H) of internal data memory contain 
iie start address (high byte, low byte respectively) of the BASIC program. 

OPBYTE = 129 (81 H) INPUT AN ASCII FLOATING POINT NUMBER AND PLACE IT ON 
THE ARGUMENT STACK. THE DPTR POINTS TO THE EXTEMML 
RAM LOCATION, WHERE THE ASai TEXT STRING IS STORED 

This routine assumes that the user has placed an ASCII text string somewhere in memory and ftat iMs 
ASCII text string represents a valid floating point number. The user then puts the DPTR to the starting 
address of this text string. After this OPBYTE is executed the text string will be converted to a valid MCS 
BASIC-52 floating point number and placed on the argument stack and flie DPTR will be advanced to the 
end of the floating point number. If the DPTR does not point to a text string that contains a Valid floati^ 
point number, the accumulator will contain an OFFH upon return. 

OPBYTE = 1S2 (98) OUTPUT, IN HEX, TO THE CONSOLE OUTPUT DRIVER, TMl 
CONTENTS OF R3:R1 

This routine is used to display HEX numbers, assuming that they are in registers R3:R1. If R3 = 0, 
leading zeros can be supressed by setting BIT 54 (36H) before calling this routine. If BIT 54 (36H) is 
cleared when this routine is called, the driver will always output four hex digits followed by the©%iRailir 
H. This routine always outputs a space character (20H) to the ewsote deyicej ladme fc^ ^pts aw 
output. BIT 54 (36H) is bit 6 of internal RAM location 38. 

■ ■ - - 
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MCS-51 MACRO ASSEMBLER 

ISIS-II MCS-51 MACRO ASSEMBLER VI. 
OBJECT MODULE PLACED IN : F4: DEMO. HEX 
ASSEMBLER INVOKED BY: ABM51 : F4: DEMO 



LOC (»J 



LINE 

t 
S 
3 
4 

9 
6 
7 
9 
f 
1$ 
11 
IS 
13 
14 
19 
16 
17 
18 
19 
SO 
SI 
SS 
S3 
S4 
S9 
S6 



SOURCE 

••»*»»•»«**»•»«»•••««*•••««*«•««»••»•••«•»••»•««»••««••»•••»•*«««»«»» 

The following is an example of a program that uses the neiii OPBYTES 
available in version 1. 1 of MC5 BASIC-92. This code is by no means 
optimized! but it is meant to demonstrate houi the user can define 
"customized" commands and statements in version 1. 1 of MCS BASIC-52. 

The neui command defined here is DISPLAY. What it dots is display m 
region of external data mefflory to the console davtc*. fhe syntax 
for this statement is: 

DISPLAY Cexpr3, Cexpr] 

Where the first expression is the starting address and the last 
expression is the ending address. In this example the DISPLAY is 
treated like a command uhlch. means that it cannot be executed in 
RUN mod*. 

The output for the DIBPLAY command is as follows: 

ADDRESS then 16 Bytes of Characttrs 1.*. 

lOOOH OOH SSH 33H 87M 

Notii, on to the program. 
•*«*««••»•»**»•««•«•»»•«#««•»«»»•••*»»»#»#«»•«««««»»««««*#»«««»»«»«*« 



(O 

> 

D 
O 
m 
o 



s 



m 

H 

o 



as-- ^s. 



LOC 


OBJ 


LINE 


SOURCE 












27 










2002 




28 




ORG 


2002H 








29 










2002 


SA 


30 




DB 


9AH 1 


T«lf batic that •rp«n«loti oiitian 






31 








present 


2048 




m 




ORO 


2048H 


2048 


D22D 








49 i 


Set the bit that s«v«»o 


204A 


22 


39 




RET 








,§§. 










2070 




'9^ 




ORG 


2070H i 


Set up DPT»«t«»j;emp table 






■ 3ffili 








2070 


90207C 


'39 




tm 


DPTR.tVECTOR TABLE 


2073 


22 






RET 










m 










2078 








OR® 


2078H 1 


Set up DPTR to expansion table 






43 








2078 


90207E 


44 




nov 


DPTR. #USER_TABLE 




207B 


22 


49 




RET 










4& 














47 


VECTOR. 


.T«8LE: 










48 










207C 


2087 


49 




DU 


D0_D1 SPLAY 1 


This is the address of DISPLAY 






90 














91 


USERTABLE: 










9S 










207E 


10 


93 




DB 


lOH J 


Token for Display 


207F 


44495390 


94 




1» 


'DISPLAY' ) 


ASCII for display 


2083 


4C4i59 










2086 


FF 


99 




DB 


OFFH ( 


End of table (short table) 






9A 


























i 


m 








' c ■. . . : ..' 






99 


DO_DISPLAY: 










60 










2087 


302F63 


61 




JNB 


47. DUMMY » 


make sure that MCS BASIC-92 is i 






63 






1 


the command mode. Bit 47 is set 






63 






I 


if it is. 



208A 7439 
S08C 120030 



64 

68 
66 
67 
68 
69 
70 



mm-' A, #97 

LCALL 30H 



) Evaluate the first expression afte 

I the keyutord display. MCS BASIC-92 

I mill handle any errors. The value 

I of the expression will be on the 

I Argument Stack 



LOG 


□BJ 


LINE 


SOURCE 






808F 


7440 


ft 




MOV 


Ai «64 


2091 


120030 


79 




LCALL 


30H 






73 








2094 


B4aC6A 


74 




GiJNE 


A. •', ' 






7S 












76 








2097 


7439 


77 




MOV 


A. #57 






78 




LGALL 


30H 






79 

80 








ao9c 


7401 


m 




MOV 


Ai •! 


209E 


120CK30 


«i 




LCALL 


30H 






83 












•« 




u 




20A1 


8918 . 


m 






18H.R1 


20A3 


SB 19 


«« 






19H. R3 






a? 








20A3 


7401 


&a 

09 




MQV 


A. «1 


20A7 


120030 


90 




LCALL 


30H 






91 




















20AA 


891A 


93 




MOV 


lAHi Rl 


20AC 


BBIB 


94 




MOV 


IBH. R3 






98 












96 












97 








20AE 


C3 


98 


LOOPl: 


CLR 


C 


20AF 


E518 


99 




MOV 


A, 18H 


20B1 


9S1A 


100 




SUBB 


A. lAH 


20B3 


E519 


101 




MOV 


A, 19H 


20B5 


951B 


1€S 




SUBB 


A. IBH 


20B7 


9004 


103 




JNC 


L00P2 


20B9 


E4 


t@« 




CLR 


A 






. •i* 




-t- ^ 




SOMk 


OSO03O 


Mi 






90H 






tm 












107 












108 








20BD 


7407 


109 


L00P2: 


MOV 


A, #7 


20BF 


120030 


no 




LCALL 


30H 






Ml 








20C2 


A91A 


tit 




MOV 


Rl. lAH 


20G4 


ABIB 






m»f 


ita. i SH 














20C6 


C236 


lis 




CLR 


36H 



Ott th« character after tha axprasslon 

and bump tha BASIC taxt pointer 

Make CHfe It it a conuna. If not do an 
error 

Evaluate the next expression (the 
ending address) and put it on the 
Argument Stack 

Cttnwgrt t)t» im^M •J^reMloii;: ttfte 
ending address) on the stack to 
an integer and put it in R3:R1 

Save the ending address in the user 
reserved locations 18H and 19H. Thltt 
is reserved as register bank 3 

Convert the first expression (the 
starting address) on the stack to 
an integer and put It In R3:R1 

Save the starting address in the user 
reserved locations lAH and IBH 

Now everything is set up to loop 

Check to make sure that the starting 
or current address is <= the ending 
address 



If the carry is set< it's over 
Oo to the command mode 

(if display was a statement instead 
of a command) this routine would 
exit with a RET 

D« • carriage return, line feed 



Output the Starting address 



Don't supress leading xeros 



LOC 


OBJ 


LINE 








20C8 


7498 


116 




MOV 


A. #98H 


20CA 


120030 


117 




LCALL 


30H 






118 








20CD 


891A82 


119 


L00P3: 


MOV 


DPL. lAH 


20D0 


891B83 


120 




MOV 


DPH. iBH 






121 








20D3 


EO 


122 




MOVX 


A. tDPTR 


20D4 


A3 


123 




INC 


DPTR 






124 








2003 


85821A 


125 




MOV 


1 AH. DPL 


SODS 


8S831B 


126 




MOV 


tBH. DPH 






127 








20DB 


F9 


128 




MOV 


Rl. A 


20DC 


7B00 


129 




MOV 


R3. #0 


20DE 


D236 


130 




SETB 


36H 


20E0 


7498 


131 




MOV 


Ai «9BH 


S0E2 


120030 


132 




LCALL 


30M 






133 








20E5 


E91A 


134 




MOV 


A. lAH 


20E7 


S40F 


135 




ANL 


A. #0FH 


20E9 


70E3 


136 




JNZ 


LOOP 3 


20EB 


80C1 


137 




SJMP 


LOOPl 






138 












139 


DUMMY: 










140 








20E0 


7407 


141 




MOV 


A. #7 


20eF 


120030 


142 




LCALL 


30H 






143 








S0F2 


7821 r.c> 


144 




HOV 


R3, #HIGH D_MS0 


20F4 


791 S 


145 




mj 


R 1 , tLOW D_MSO 


20F6 


D234 


146 




SETS 


32 


20F8 


7406 


147 




MOV 


A. «6 


20FA 


120030 


148 




LCALL 


30H 


20FD 


E4 


149 




CLR 


A 


20FE 


020030 


150 




LJMP 


30M 






151 












152 


C_ERROR 










153 








2101 


7407 


194 




MOV 


A. «7 


2103 


120030 


195 




LCALL 


30H 






156 








2106 


7B21 


157 




MOV 


R3. ttHIGH C MSG 


2108 


793B 


158 




MOV 


Rl.ttLOU CJ180 


210A 


D234 


159 




SETB 


52 


210C 


7406 


160 




MOV 


A. «6 


210E 


120030 


161 




LCALL 


30H 



Nowi tvt up to r««d 16 byt*s 
put addrtsa in DPTR 



Read the byte in external RAM 
Bump to the neit location 

iavo tha AddraaR 

Output the byte 

The high byte it alwawt xfro 

Supra laadlng turmm. 

Check to aea if on a 16 bgta boundry 
Loop until on a 16 Byte Boundry 

Do a carriage return-line faad 

Biaptay tta error tnaasage 
Vvint from ROM 

Go back to the coniffland mode 



Do what we did before 



LOC 


OBJ 


LINE 


2111 


E4 


i&a 


ai«2 


0S0030 


163 






1&4 


SllS 


44495350 


169 


2119 


4C 4 15920 




2110 


49532041 




2121 


20434F4D 




2129 


4D414E44 




2129 


2C204E4F 




212D 


54204120 




2131 


53544154 




2135 


454D494E 




2139 


5422 










213B 


594F5520 


167 


213F 


4E454544 




2143 


20412043 




2147 


4F4D4D41 




214B 


20544F20 




214F 


4D414B45 




2153 


20444953 




2157 


504C4159 




215B 


20974F52 




21 5F 


4B82 





CLR 
LJMP 



DJISO: OB 



A . 
30H 

'DISPLAY 18 A COMMAND! NOT A STATEMENT'" 



C_M80: DB 



'YOU NEED A COMMA Ttl MAKE DISPLAY WORK" 



> 

a 
u 
m 
O 



39 
O 
C 
H 

m 



168 
169 



END 



ASSEMBLY COMPLETE, NO ERRORS FOUND 
(that't all it takes) 
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9.T INTERRUPTS 

latemipts can be handled by MCS BASlC-52 in two distinct ways. The first, which has akeady been 
ffi^ssed, allows statements in an MCS BASIC-52 program to peaform the required intemipt routlRe. Ute 

ONTIME and ONEXl statements enable this particular interrupt mode. Additionally, setting BIT 26. IH 
permits EXTERNAL INTERRUPT to act as a "fake" DMA input and the details of this feature are in 
tte BELLS, WHISTLES, and ANOMALIES sfecti&h of dris manual. The second method of handling 
interrupts in MCS BASIC-52 allows the programmer to write assembly language routines to perform the 
interrupt task. This method yields a much faster interrupt response time, but, the progranuner must exercise 
|iara& cautioQ. ••» •• ' 

All iuterrupt vectors on the MCS BASIC-52 device are "mirrored" to external PROGRAM MEMORY 
LOCATIONS 4003H through 402BH inclusive. The only MCS BASIC-52 STATEMENTS that enable the 
interrupts on the 8052AH are the CLOCK 1 and the ONEXl STATEMENTS. If interrupts are NOT enabled 
by these STATEMENTS, BASIC assumes that the USER is providing the interrupt routine in assembly 
A^guage. TTie vectors for lie various interrupts are as follows: 

LOCATION— INTERRUPT 

4003H- — -EXTERNAL INTERRUPT 

t"«X)BH—— TIMER 0\^RFLOW 

4013H EXTERNAL INTERRUPT 1 

401BH TIMER 1 OVERFLOW 

4023H SERIAL PCmT 

402BH TIMER 2 OVERFLOW/EXTERNAL INTERRUPT 2 

The programmer can enable interrupts in MCS BASIC-52 by using the statement IE = lE.OR.XXH, where 
XX enables the appropriate interrupts. The bits in the interrupt register (IE) on the 8052 AH are defined 
m IedUows: 



BIT 7 


6 


5 


4 


3 


2 


1 





EA 


X 


ET2 


ES 


ETl 


EXl 


ETO 


EXO 


ENABLE 


UNDE- 


TIMER 2 


SERIAL 


TIMER 1 


EXT 1 






ALL 


FINEO 




PORT 











Hi < 5J. J 
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9.7 INTERRUPTS 

Interrupts are enabled when the appropriate BITS in the IE register are set to a one. Details of the 8052 AH 
interrupt structure are available in the MICROCONTROLLER USERS MANUAL available from INTEL. 



IMPORTANT NOTE!! 



Before MCS BASIC-52 vectors to the USER interrupt locations just described, the PROCESSOR STATUS 
WORD (PSW) is PUSHED onto the STACK. So, the USER does not have to save the PSW in the assembly 
language interrupt routine!!! HOWEVER, THE USER MUST POP THE PSW BEFORE RETURNIMG 
FROM THE INTERRUPT. 



VERY IMPORTANT NOTE!!! 



If the user is running some interrupt driven "background" routine while MCS BASIC-52 is running a 
program, the user MUST NOT CALL any of the assembly language routines available in the MCS BASIC-52 
device. The only way the routines in the MCS BASIC-52 device can be accessed is when the CALL 
statement in MCS BASIC-52 is used to transfer control to the users assembly language program. The 
reason for this is that the MCS BASIC-52 interpreter must be in a "known" state before the user can call 
the routines available in the MCS BASIC-52 device and a "random" istampt does not gUMaatee (bat the 
interpreter is in this known state. The usCT shoidd use REGISTER BANK 3 to handle interrupt routines 
in assembly language. 
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9.8 RESOURCE ALLOCATION 

Specific statements in MCS BASIC-52 require the use of certain hardware features on the device. If the 
user wants to use these hardware features for interrupt driven routines, conflicts between BASIC and the 
assembly language routine may occur. To avoid these potential conflicts, the programmer needs to know 
what hardware features are used by MCS BASIC-52. The following is a list of the COMMANDS and/or 
STATEMENTS that use the hardware features on the 8052 AH. 

CLOCKl — uses TIMER/COUNTER in the 13 bit 8048 mode. 
PWM — uses TlMEEyqi^^fflllR 1 ia the 16 bit made ( ,« 

LIST# — uses TIMER/COUNTER 1 to generate baud rate in 16 bit mode 
PRINT# — same as LIST# . /- 

, , , PROG — uses TIMER/COUNTER 1 for progrmuning pulse 
ONEXl — uses EXTERNAL INTERRUPT 1 

In addition, TIMER/COUNTER 2 is used to generate the baud rate for the serial port. What the preceding 
list means is that if CLOCKl, PWM, ONEXl, LIST#, PRINT#, and PROG commands/statements are 
used by the programmer, the user MAY NOT use the associated TIMER/COUNTER <x EXT]^;^^^ 
INTERRUPT pin for an assembly language routine. 

MCS BASIC-52 initializes the TIMER/COUNTER modes by writing a 244 (0F4H), 16 (lOH), and 52 
(34H) to the TCON, TMOD, and T2C0N registers respectively. These registers are initialized only during 
RESET initialization sequence, and MCS BASIC-52 assumes that these registers arc NEVER changed. 
So, if the user changes the contents of TCON, TMOD, or T2CON, something funny and/or disastrous is 
bound to happen if the Statements/Conmiands listed above are executed. If the user does not execute any 
of the previously mentioned Steitec^Qte or Commands, die user is fnee to use the interrupts in any way 
suitable to the application. 



CHAPTER 10 
System Configuration 



10.1 MEMORY/HARDWARE CONFIGURATION 

MCS BASIC-52 always requires at least IK bytes of external memory. After reset, MCS BASIC-52 sizes 
the external memory. If less than IK bytes of external memory are available, MCS BASIC-52 will not 
"sign-on," in fact, it will internally loop fiwever . Tins obviotisly is not too exdting, so k is wise toliaog 
some extern^ memory on the MCS BASIC-S2 device. 

MCS BASIC-S2 sizes consecutative external memory locations fixtm OOOOH until a memory failure is 
detected. The sizing operation is performed simply by writing a 5AH to an external memory location, then 
testing the location. If the particular memory location passes this test, BASIC then writes a OOH to the 
location, then again, checks die location. MCS BASIC-S2 only sizes the external memory fix)m locations 
through ODFFFH. Memory locations OEOOOH through OFFFFH are res»ved for user I/O and/oar assanbly 
language programs. 

The MCS BASIC-52 program resides in the 8K of ROM available in INTEL'S 8052AH device and as a 
result requires that external memory be "partitioned" in a specific manner. The architecture of the 805 2AH 
is NOT Von Neumann. This means that Data and Program Memory do not reside in the same physical 
address space on the 8052AH. Specifically, the RD (pin 17) and WR (pin 16) pins on the 8052AH are 
used to enable DATA memory and PSEN (pin 29) pin is used to enable PROGRAM memory. Depending 
on the hardware configuration, MCS BASIC-S2 operates in two distinct "memory" modes. 

RAM ONLY MODE ' 

In this mode of operation. Read/write memory is connected to the MCS BASIC-52 device starting at 
memory address OOOOH. Memory can be placed up to location OFFFFH. In this mode of operation the 
decoded addresses are used to generate the CHIP SELECT (CS) signal for the RAM devices. The RD pin 
on the" 8052AH is used to generate th e OUTP UT ENABLE (OE) strobe and the WR pin generates the 
WRITE ENABLE (WE or WR) strobe. PSEN is not used in the RAM only mode of operation. The RAM 
only mode of operation offers the simplest hardware configuration available for the MCS BASIC-52 
device. An example of this configuration is shown in Figure 1 . Since PSEN is not used in the RAM only 
mode, the user may not CALL assembly language routines. The RAM only also does not support EPROM 
programming. In general, the RAM Mily mode will be used only to "check out" the (tevice during the 
initial sy^em development stage. 
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10.1 MEMORY/HARDWARE CONFIGURATION 
RAM/EPROM MODE 

The RAM/]S>IiOM mode of c^iraatkn allows for tfie eon^lete syst^ impksnentaticm of MCS.B^i&S£. 
This mode of operation requires that external memory be mapped in a certain manner. The RAM/EPROM 

memory configuration is as follows: 

1) The RD and the WR pins on the MCS BASIC-52 device are used to enable RAM memory that is 
addressed from OOOOH to 7FFFH. Addresses are used to decode the chip select (CS) for the RAM 
(tevices and RD and WR are used to enable the OE and WE or (WR) puis respectively. 



2) The PSEN pin on the MCS BASlC-52 device is used to enable EPROM memory that is addressed from 
2000H to 7FFFH. Addresses are used to (iyNx>d6lfaedup sas(»(C^MiMiM^QM 'devices and 
is used to enable the OE fm* 



3) For addresses between 8000H and OFFFFH both the RD and flie PSEN pin on the MCS BASIC-5t 

device are used to enable the memory. Either EPROM or RAM devices can be placed in this address 
space. To permit both the RD and the PSEN pins to enable addresses in this address space, RD and 
PSEN must be logically "ANDED" together. This can be accomplished with a simple TTL gate such 
as a 74LS08. The WR pi n on t he MCS BASIC-52 device is used to write to RAM memory in this 
same address space. The PSEN and RD signals do not have to be anded beyond address 7FFFH to 
enable MCS BASIC-52 to program an EPROM. This is only a suggestion since it will permit the user 
to execute assembly language routines as well as MCS BASIC-S2 pe^^rams that are located in this 
address space. 
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10.1 MEMORY/HARDWARE CONFIGURATION 

This scheme of memory addressing actually permits MCS BASIC-52 to address 96K bytes of memory, 
32K of RAM devices , 32K of EPROM/ROM devices and 32K of combined RAM/EPROM/ROM devices. 
Since RD and PSEN are ANDED for addresses from 8000H through OFFFFH, the 8052AH "looks like" 
a Von Neumann machine in this address space. The XBY and CBY special functi(Mi (q)eratcns will yield 
the same value when their arguments are between 8000H and OFFFFH. 

When the EPROM programming feature in MCS BASIC-52 is used, BASIC assumes that the EPROM to 
be programmed is addressed starting at location 8000H. MCS BASIC-52 can only program EPROMS 
addressed between 8000H and OFFFFH. When the PROG connmand is used for the first time, on an erased 
EPROM, MCS BASIC-52 stores this program beginning at address 80I0H. Locations 8000H through 
800FH are used to save the baud rate informatioa, plus ccmfigiration information. Some suggestions te 
knplemmtation of tlie RAM^PROM awde ai« iliovra in iguie 2. 
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ms EPROM PROGRAMMING CONFIGURATION/TtMINCi 

With the proper hardware, the MCS BASIC-52 device can program just about any EPROM or EEPROM 
device. The only requirement for EPROM programming is that the EPROM to be programmed is addressed 
starting at location 8000H. MCS BASIC-52 requires very little external hardware to programs EPROMS. 
All of the critical EPROM programming timings are generated by threel/O port pins on the MCS BASIC-52 
device, lliese pins [Hovide die foUowiiig signals: i 

P1.3 — ALE DISABLE 

PORT 1, BIT 3 (pin 4 on the 8052AH) is used to DISABLE the ALE signal to the external latched required 
by the 8052AH when external memory is addressed. This pin should be logically ANDED with ALE. A 
itople TTL gate, such as a 74LS08 can be used to perform the ANDING function. Under normal ®pra^Qi| 
PI. 3 is in a logical high state (1). ONLY DURING EPROM PROGRAMMING IS PI. 3 PLACED IN A 
LOGICAL LOW STATE (0). Disabling the ALE signal to the external latch is required to program EPROMS 
l^e^ouse of die way MCS BASIC-52 carries out die EPROM i»x>grmmmng process. 

During programming, MCS BASIC-52 treats 1/0 PORT and I/O PORT 2 as I/O ports, not as address/ 
dtda ports. MCS BASIC-52 first writes the low order address to be programmed to PORT 0. The data in 
PORT is then latched into the external address latch and then MCS BASIC-52 disables the ALE signal 
to the latch by clearing bit PI. 3. Thus, the low order address is "permanently" stored in the &}sjtm^ 
iMeh. MCS BASIC-S2 then writes the iAga order address to PORT 2 and the DATA to be goK^mma^ 
to PORT 0. So, the external address latch contains the low order address, PORT 2 ccHttpie tiie high ordto 
address, and PORT contains the DATA when EPROM programming occurs. 

IMPORTANT NOTES 

When PORT on the 8052AH is used as an I/O port, the output structure is an "open drain" configuration. 
This requires that ' 'pull-up' ' resistors be placed on PORT to permit MCS BASIC-52 to program EPROMS. 
Experimentally, lOK ohm pull-ups resistors on PORT have yielded satisfactory results. 

In Version I.I, INTO must be kept high when propanuning EPROMs. 
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10.2 EPROM PROGRAMMING CONmimTI@li/tfMING 
PI .4 — PROGRAM PULSE WIDTH 

PORT 1, BIT 4 (pin 5 on the 8052AH) is used to provide the 50 millisecond or the 1 millisecoaid 
programming pulse. The length of the programming pulse is determined by whether the "normal" or flie 
"INTELligent" EPROM programming mode is selected. MCS BASIC-52 calculates the length of the 
programming pulse from the assigned crystal value. So, be sure the proper XTAL has been assigned. The 
accuracy of this pulse is within 10 CPU clock cycles. This pin is normally in a logical high (1) state. It 
is asserted low (0) to program the EPROMS. Depending on the EPROM to be programmed this signal 
will be used in different ways. More about this later. 

PI .5 — ENABLE PROGRAM VOLTAGE 

PORT 1 , BIT 5 (pin 6 on the 8052AH) is used to enable the EPROM programming voltage. This pin is 
normally in a logical high (1) state. Prior to die EPROM programming operation, tfiis pin is brought to a 
logical low (0) state. This pin is used to turn on or off the high voltage (12.5 volts to 25 volts, depending 
on the EPROM) required to program the EPROMS. 

The timing for the EPROM programming pins is shown in figure 3. The hardware required to program 
different devices is shown in figure 4. Note that with very little external hardware the MCS BASIC-52 
device can program virtually all conomeicially available EPROK^. Additiotially, figure S suggests a citeMt 
using an INTM. 2816A EEPROM. This circuit also fixtures a push button erase option. 

IMPORTANT NOTE 

MCS BASIC-52 calculates the programming pulse width when the XTAL value is assigned. To insure 
proper programming, make sure XTAL is assigned the proper value. MCS BASIC-52 performs flie pro- 
gramming pulse width calculation to within 5 clock cycles, so the accuracy of the programming pulse is 
well within the limits of any EPROM device. 



10.3 SERIAL PORT IMPLEMENTATION 

The serial port I/O signals on the 8052AH are TTL compatible signals. They are typically not compatible 
with most terminals. Figure 6 suggests hardware options for making fee serial interface compatible with 
terminals. The serial port is initialized by MCS BASIC-52 to the 8-bit nart mode. In this mode 8 data bks, 
plus one start and one stop bit are transmitted. Parity is not used. 
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CHAPTER 11 
Reset Options (Version 1.1 Oniy) 



Version 1.1 of MCS BASIC-52 contains numerous RESET options that were not available in Version 
They are discussed in detail in chapters 3.2 through 3.5 of this manual. Briefly, they are as follows: 

PR0G1 

Saves only the serial port baud rate for a power-up ot RESET con^Uoa, 
PIIOG2 

Saves die serial port baud ms saad automatically runs tibe first program tiiat is saved in EPROM (S^'a 
power-up or RESET conditio. 

PR0G3 

Saves the serial port baud rate plus the assigned MTOP value. If RAM is available beyond the assigned 
MTOP vzias, it will not be cleared during a power-up or RESET ccHMi#. ' 

PR0G4 

Saves the serial port baud rate plus the assigned MTOP value, just like PR0G3, but also autmnirtieal^ 
runs the first program that is saved in EPROM on a power-up or RESET condition. 

pm>Gs 

Does die same thing as I^ftiOGM, however, if external memory location SFH ccmtains the character OASH 

on a power-up or RESET condition, external memory will atl^llIK t^^PSdsi TWs mode assumes that die 
user has employed some type of memory back-up. 
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RESET OPTIONS (VERSION 1.1 ONLY) 
PR0G6 , , 

Does the same thing as PROGS, but CALLS external program memory location 4039H during a RESET 
or power-up sequence. This option also requires the user to put the character 0A5H in external memory 
location 5FH to insure that external RAM will not be cleared during RESET or power-up. The user must 
put an assembly language RESET routine in external memory location 4039H or else this RESET mode 
will crash. When the user returns &om the customized assembly language RESET routine, three options 
exist: 

OPTION 1 FOR PR0G6 

If the CARRY BIT is CLEARED (CARRY = 0) upon return from the user RESET routine MCS BASIC- 
52 will enter the auto-baud rate determining routine. The user must then type a space character (20H) on 
the terminal to complete the RESET routine and produce a RESET message on the terminal. 

OPTION 2 FOR PR0G6 

If the CARRY BIT is SET (CARRY = 1) and BIT of the ACCUMULATOR is CLEARED (ACC. 
= 0) MCS BASIC-52 will produce the standard sign-on message upon return from the user supplied 
RESET routine. The baud rate will be the one that was saved when the PROG6 option was used. 

OPTION 3 FOR PR0G6 

If the CARRY BIT is SET (CARRY = 1) and BIT of the ACCUMULATOR is SET (ACC. 0=1), 
MCS BASIC-52 will execute the first program stored by the user in EPROM (starting address of the 
program is 8010H) upon letum from the wser supplied RESET routine. 
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RESET OPTIONS (VERSION 1.1 ONLY) 

If these options are still not sufficient to adtkess the needs of a specific q>pUcation, one other option exists 
and it functions as follows: 

After RESET, MCS BASIC-52 initializes the SPECIAL FUNCTION REGISTERS SCON, TMOD, TCON, 
and T2CON with the following respective values, 5AH, lOH, 54H, and 34H. If the user places the c haracte r 
OAAH in external CODE MEMORY location 2001H (remember CODE MEMORY is enabled by PSEN), 
MCS BASIC-52 will CALL external CODE MEMORY location 2090H immediately after these special 
function registers are initialized. No crtfaer registers or msmoty locations will be sltaed except that the 
ACCUMULATOR will contain a OAAH and the DPTR will contain a 2001H. 

Since MCS BASIC-52 does not write to above mantioned Special Function Registers at any time except 
during the RESET or power-up sequence the user has the option of modifying any of the Special Function 
Registers with this RESET option. Upon returning from this RESET mode, the MCS BASIC-52 software 
package will clear the intenud memory of the ^5tAH md ptmBed m^^ RESET roaine. The F!I@M 
through PROG6 options wffl lite^W M ussEd'. ' " v-«*>«) <!. 

Now, suppose the user does not want to enter the normal RESET routines, or the user wants to iiiif^^f^it 

some type of "warm" start-up routine. This can be accomplished simple by initializing the necessary 
Special Function Registers and then jumping back into either MCS BASlC-52's COMMAND mode or 
RXM MODE. For a warm start-up ot RESET (warm means that the MCS BASIC-52 device was RESEt, 
but power was not removed — i.e. the user hit the RESET button) the following must he initialized: 

SCON, TMOD, TCON, T2C0N, if the user does not want to use the values that MCS BASIC-52 suppli^. 

RCAP2H and RCAP2L must be loaded with the proper baud rate values. If the user has programmed an 
BHR.0M with one of the PROGI through PROG6 options, die proper baud rate value will be stored in 
external DATA MEMORY locations 8001H (RCAP2H) and 8002H (ROy^ZL), 

The STACK POINTER (Special Function Register SP) must be initialized with the contents of the STACK 

POINTER SAVE location, which is in internal DATA MEMORY location 3EH. A MOV SP, 3EH assemtty 
language instruction will accomplishment the STACK POINTER initiahzation. 



r1 - 1 

•li, ( .V - , 
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RESET OPTIONS (VERSION 1.1 ONLY) 

After the above are initialized by the user sup[die4 RESET vmHOm^'&ss vmt may enter MCS BASIC-52's 
command mode by executing the following: 

CLR A 
LJMP 30H 

Now, it is important to remember that the previous description applies only to a "warm" RESET with 
power remaining to the MCS BASIC-52 system. This means that the user must also provide some way of 
detecting the difference between a warm RESET and a power-on RESET. This usually involves some type 
of flip-flop getting set with a power-on-clear signal from the users power supply. The details of imple- 
mentating this RESET detection mechanism will not be discussed as the possible hardware options 
vary dependuig upon the design. 

The user may also implement a "cold start" reset option with the previously described reset mode. The 
following code details what is a&mum^ to implemsnt a stsat &^m. 

EXAMPLE: 



ORG 

j 

DQ 


200 IH 

OAAH 1 


TELL BASIC THAT RESET IS EXTERNAL 


1 

ORG 
1 


2070H 1 


LOCATION BASIC WILL CALL FOR RESET 


■ ' 1 ; 


AT THIS POINT BASIC HAS PLACED A 9AH IN 
SCON, A lOH IN TMOD. A 9m W TCOM AffD, 
A 34H IN T2C0N 


> 

MOV 
CLR 


RO. »OFFH ) 

A > 


FIRST CLEAR THE INTERNAL MEMORY 

LOAD RO WITH THE TOP OF INTERNAL MEHQRY 

SET ACCUMULATOR «■ 


i 

RESET 1: MOV 
DJNZ 


«R0. A i 
RO. RESET 1 


LOOP UNTIL ALL THE INTERNAL RAM IS CLEARED 


1 

nov 

MOV 

1 


8P. «4DH 1 
3EH. »4DH 1 


NOW SET UP THE STACK POINTER AND THE STACK 
POINTER HOLDING REGISTER 

4DH IS THE INITIALIZED VALUE OF THE STACK 
THIS IS THE SP HOLDING REGISTER 




NOW CLEAR THE EXTERNAL RAM. IN THIS 
EXAMPLE ASSUME THAT IFFFH BYTES OF RAM 

ARE AVAILABLE 

THE USER MUST CLEAR AT LEAST THE FIRST 512 
BYTES OF RAM FOR A COLD START RESET 


1 

MOV 
MOV 
MOV 
i 


R3, #HIGH IFFFH 
Rl.ttLOM IFFFH 
DPTR. ttOFFFFH 
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RE^ra: INC DPTR i DPTR » THE FIRST TIME THRU 

CLR A 

MOVX SOPTR. A I CLEAR THE RAM. A MEMORY TEST PROGRAM COULD 

i BE IN THIS LOOP 

MOV A. R3 I NOW TEST FOR THE MEMORY LIMITS 

CJNE A. DPH. RESETS 

C^ ^.^i:,RE8iT3 
> 

I WHEN YOU OET HERE. YOU ARE DONE 
I 

I NOW SET UP THE MEMORY POINTERS. FIRST MTOP 
I 

MOV DPTR, #10AH i LOCATION OF MTOP IN EXTERNAL RAM 

MOV A, «HIOH IFFFHi SAVE MTOP 

MOVX SDRTR, A 

INC DPTR i NOW. SAVE THE LOW BYTE 

MOV A. #LOW IFFFH 

MOVX SDPTR.A 
) 

I NOW SET UP THE VARTOP POINTER. WITH NO STRINGS. 
I VARTOP - MEMTOP 

) 

) LOCAtlQN ir VARTOP IN EXTERNAL HAM 



MOV 


DPTR, #104H 


MOV 


A, #HIGH IFFFH 


MOVX 


«DPTR. A 


INC 


DPTR 


MOV 


A, #LOW IFFFH 


MOVX 
f 


SDPTR, A 


1 

1 NOW 


SAVE THE MATRIX 



INTER "DIMUSE", THIS POINTER IS 
i DESCRIBED IN THE APPENDIX, WITH NO PROGRAM IN RAM. 
i DIMUSE - 928 AFTER RESET 
I 

MOV DPTR, #10BH j LOCATION OF DIMUSE IN EXTERNAL RAM 

MIV A. ttHIGH S28 

MOVX «OPTR. A 

INC DPTR 

MOV A, ttLOW 528 

MOVX fiDPTR. A 

I 

; NOW SAVE THE VARIABLE POINTER "VARUSE" THIS POINTER IS 

I ALSO DESCRIBED IN THE APPENDIX. AFTER RESET VARUSE - VARTOP 

I 

MOV DPTR.»106H < UEICATXXm IT VAIil;^ £N ^EXTERNAL RAM 

MOV A. •HIGH IFFFH 

MOVX eDPTR. A 

INC DPTR 

MOV A. «LOW IFFFH 

MOVX eDPTR. A 

I NOW SElrt^ ^ifASICS CONTROL STAdK AND ARGUMENT STACK 

I 

MOV 9H, #OFEH I THIS INITIALIZES THE ARGUMENT STACK 

MOV IIH, #OFEH ) THIS INITIALIZES THE Cra4TR0L STACK 

( 

» NOW TELL BASIC THAT NO PROGRAM IS IN RAM. THIS IS NOT NEEDED 

I IF THE USER HAS A PROGRAM IN RAH 

i 

MOV DPTR, #512 i LOCATION OF THE START OF A USER PROGRAM 

ITOV A. #01H I END OF FILE CHARACTER 

MOVX mitm*A 
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RESET OPTIONS (VERSION 1.1 ONLY) 



XTAL: 



I 

I NOW PUSH THE CRYSTAL VALUE ON TO THE STACK AND LET BASIC 
I CALCULATE ALL CRYSTAU DEPENDENT PARAMETERS, 

I 

SJMP 

; 

DB 88H i 

DB OOH t 

DB 
DB 
08 
DB 
I 



RESETS 

88H 
OOH 
OOH 
92H 
09H 

IIH ^ 



THIS IS THE FLOATING POINT VALUE 
FOR AN 11.0992 MHZ CRYffTAI. 



RESETS: 



RE8ET4: 



UP TO PUSH CRYSTAL VALUE 
THE ARO STACK 



I ^REMENt ARO PXACK BY ONE FP NUMBER 



SAVE THE CALCULATED ADDRESS IN RO 
THIS IS THE ARG STACK PAGE ADDRESS 
NUMBER OF BYTES TRANSFER 



TRANSFER ROM CRYSTAL VALUE TO 
AROUMENT STACK OF BASIC 



THE 



MOV DPTR, «XTAL i SET 

MOV A, 9 J GET 

CLR 
SUBB 
MOV 
MOV 
MOV 
MOV 
) 

CLR 
MOVC 
MOVX 
INC 
DEC 
DJNZ 
} 

i NOW CALL BASIC TO DO ALL THE CRYSTAL CACULATI0N8 

I 

MOV A. »S8 I 

LCALL 30H i 
i 

NOW TELL BASIC WHERE START OF THE USER BASIC PROGRAM IS 
BY LOADING THE START ADDRESS, IF THE PROGRAM IS IN EPROM 
13H WOULD - HIGH 801 IH AND 14H - LOW 801 IH. ANYWAY 
ADDRESS 13H: 14H MUST POINT TO THE START OF THE BASIC 
PROGRAM 



DPTR, «XTAL 

A, 9 

C 

A. tt6 
9. A 
RO, A 
P2. ttl 
Rl.«6 

A 

A. CA-KDPTR 
CRO. A 
DPTR 
RO 

R1,RESET4 



I BUMP THE POINTERS 



I LOOP UNTIL THE TRANSFER IS COMPLETE 



OPBYTE FOR CRYSTAL CALCULATION 
DO THE CALCULATION 



I 
t 
I 
I 

I 
I 

MOV 
MOV 



13H. ttHIGH 912; 
14H>«L0W 912 I 



THIS TELLS BASIC THAT THE START OF 
THE PROGRAM IS IN LOCATION 912 



I 

I NOW THE SERIAL PORT MUST BE INITIALIZED, THE USER 

i CAN SET UP THE SERIAL PORT TO ANY DESIRED CONFIGURATION 

I HOWEVER, THIS DtW CObE WTLL SHOW THE AUTO BAUD 

I ROUTINE 



MOV 
MOV 
MOV 
JB 



R3, #00H 
R 1 , #00H 
RO. tt04H 
RXD. « 



INITIALIZE THE AUTO BAUD COUNTERS 



I LOOP IMTIL A START BIT IS RECEIVED 



inteT 



irC8« BASICS 



RESET OPTIONS (VERSION 1.1 ONLY) 



REKT9: 





RO. • 




1 WASTE 8 CLOCKS INITIALLY. SIX CLOCKS 
1 IN THE LOOP (16) TOTAL 


CLR 


e 




J 1 CLOCK (1> 


mv 


A.Rl 




1 1 CLOCK (2) 


SUBB 


A. •! 




1 1 CLOCK (3) 


MOV 


Rl.A 




1 1 CLOCK (41 


MOV 


A. R3 




1 1 CLOCK (9> 


SUBB 


A. tOOH 




1 1 CLOCK — R3:R1 - R3: Rl - 1 (6) 


MOV 


R3. A 




1 1 CLOCK (7) 


MOV 


RO.«a 




1 1 CLOCK (8) 


^8 


RXD. RESETS 


1 2 CLOCKS (10). WAIT FOR END OF SPACt 


JB 


RXD. • 




1 WAIT FOR THE SPACE TO END (20H) 


JNB 


RXD. • 




1 WAIT FOR THE STOP BIT 


MOV 


RCAPSH. 


R3 


1 LOAD THE TIMER 2 HOLDING mmVtmm 


MOV 


RCAfSL. 


Rl 



R3. ttHIOH MSO 
Rl.ttLOW Mse 

92 

A. 46 
30H 



I PUT MOtt&BB OF MESSAOE IN R3: Rt 



PRINT FROM ROM 
OP BYTE TO PRINT 



MSO: 



i 

I NOW YOU CAN ADD A CUSTOM SIGN ON MESSAOE 
I 

HQV 
MOV 
BEJB 
MOV 
LCALL 
I 

I NOW OUTPUT A CR LF 

I 

MOV 
LCALL 
i 

I 00 TO 

i 

CLR 
JMP 
i 

DB 
DB 

I 

END 



TEXT STRING 



A, #7 
30H 



I OP BYTE FOR CRLF 



THE 
A 

30H 



COMMAND MODE 



>H i Jlf ) -t m'n)()» I 



'CUSTOM SIGN 
22H 



ON MESSAGE' 

I TERMINATES MESSAGE 
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RESET OPTIONS (VERSION 1.1 ONLY) 

To Summiaize what the user must to suecessfuUy HE^lemeat a "CX)LD ST^T'' RESET: 

1) The user must clear the internal RAM of the MCS BASIC-52 device and at least the first 512 bytes #f 
external RAM memory. 

2) The user must initialize the stack pointer (special function register — SP) and the stack pointer holding 
register (internal RAM location 3EH) with a value that is between 4DH and OEOH. 4DH gives MC^ 
BASIC-52 the maximum stack size. 

3) The user must initialize the following pointers in external RAM. MTOP at location lOAH (high byte) 
and lOBH (low byte). VARTOP at locations 104H (high byte) and 105H (low byte). DIMUSE at 
locations 108H (high byte) and 109H (low byte). VARUSE at locations 106H (high byte) and 107H 
(low byte). Details of what needs to be in these locations are pres^ted in appendix 1.7 of this manu^. 

4) The Control stack pointer (location IIH in internal memory) and the Argument stack pointer (location 
09H in internal memory) must also be initialized with the value OFEH. If the user is not going to assign 
the XTAL (crystal) value in BASIC, then the XTAL value must be pushed onto the argument stack 
and the user must to an OPBYTE 58 call to MCS BASIC-52. 

5) The User must also initialize the start address of a program. The start address is in locations 13H (high 
byte) and 14H (low byte) of internal data memory. If the user BASIC program is in RAM, then 13H: 
14H = 512, if the user program is the the first program in EPROM, then 13H: 14H = 801 IH. 

6) The user must finally initialize the smal port. Any scheme can be used (as long as it works!!) 

The added reset options should go a long way toward making MCS BASIC-52 configurable to any custom 
application. 



inter 



CHAPTER 12 
Command/Statement Extensions (Version 1.1 Only) 

MCS BASIC-52 VI. 1 provides a simple, but yet effective way for the user to add COMMANDS and/or 
STATEMENTS to the ones that are provided on the chip. All the user must do is write a few aa^le^ 
programs diat will reside in external code memory. The step by step approach is as follows: 

The user must first inform the MCS BASIC-52 device that the expansion options are available. This is 
dlHie by putting the character 5AH in CODE memory location 2002H. When MCS BASIC-52 enters the 
command mode it will examine CODE memory location 2(X)2H. If a 5AH is in this location, MCS BASIC- 
52 will CALL external CODE memory location 2048H. The user must then write a short routine to SET 
BIT 45 (2DH), which is bit 5 of internal memory location 37 (decimal) and place this routine at code 
memory location 2048H. Setting BIT 45 tells MCS BASIC-52 that tbd &i;^mmm option is available. The 
following simple code will accon^lish all thsA is stated above: 



ORG 2002H 
Hf r DB 5AH 

OG 2048H 

SETB 45 
RET 

STEP 2 

Wifll BIT 45 SET, MCS BASIC-52 will CALL external CODE memory location 2078H everytime it 

attempts to tokenize a line that has been entered. At location 207 8H, the user must load tbe DPTO (Dstta 
Pointer) with the address of the user supplied lookup table, complete with tokens. 
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MCS« BASIC-52 



COMMAND/STATEMENT EXTENSIONS (VERSION 1.1 ONLY) 
STEP 3 

The user needs the following information to genmte a us^ token t^le: 

1) THE USER TOKENS ARE THE NUMBRES lOH THROUGH IFH (16 TOKENS AVAILABLE) 

2) THE USER TOKEN TABLE BEGINS WITH THE TOKEN, FOLLOWED BY THE ASCII TEXT 
THAT IS TO BE REPRESENTED BY THAT TOKEN, FOLLOWED BY A ZERO (OOH) INDICATING 
THE END OF THE ASCH, FOUXyWED BY THE NEXT TOKm«I. 

3) THE TABLE IS TERMINATED WITH THE CHARACTER OFFH. 
EXAMPLE: 



ORG 


20701 




1 

MOV 


DPTR. *U^_TABL.E 


RET 






1 

ORG 


2200H 


iTHIS DOES NOT NEED TO BE 


; 




(IN #tIB LOCATION 


USER.TABLE: 






1 

DB 


lOH 


1 FIRST TOKEN 


DB 


'DIWLAY' 


lUSER KEYUORD 


DB 


OOH 


1 KEYWORD TERMINATOR 


1 

OB 


UH 


J SECOND TOKEN 


DB 


'TRANSFER ' 


) SECOND USER KEYWORD 


DB 


OOH 


» KEYWORD TERMINATOR 


1 

DB 


12H 


/THIRD TOKEN (UP TO 16) 


DB 


'ROTATE' 


) THIRD USER KEYWORD 


DB 


OFFH 


lEND OF USER TABLE 



This same user table is used when MCS BASIC-S2 "de-tokenizes" a line during a IJST. 
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COMMAND/STATEMINT EXf»ISIOI«S ^ft^ON 1 .1 ONLY) ' 
STEP 4 

Step 3 tokenizes the user keyword, this means that MCS BASIC-52 translates the user keyword into the 
user token. So, in the preceding example, the keyword TRANSFER would be replaced with the token 
1 IH. When MCS BASIC-52 attempts to execute the user token, it first makes sure that the user expansion 
option BIT is set (BIT 45), then CALLS location 2070H to get the address of the user vector table. This 
address is placed in the DPTR. The user vector table consist of series of Data Words that define the address 
^c^lie user assembly language routines. 

EXAMPLE: 



ORG 

; 

MOV 
RET 


2070H i LOCATION BASIC CALLS TO 
>GET USER LOOKUP 


DPTR. «VECTOR_TABLE 


1 

VECTOR.TABLE: 




i 

DM 
DW 
DW 


RUN_DI8PLAY i ADDRESS OF DISPLAY 

1 ROUTINE, TOKEN ( 10H> 

RUN_TRAN8PER » ADDRESS OF TRANSFER 
1 ROUTINE, TOKEN (IIH) 

RUNJIOTATE i ADDRESS OF ROTATE 

; ROUTINE, TOKEN <12H) 


; 

ORG 
1 

RUN_DI8PLAY: 


2300H J AGAIN. THESE ROUTINES 
iMAY BE PLACED ANYWHERE 




1 l^ER 


ASM CODE FOR DISPLAY GOES HERE 


RUN_TRAN8FER: 




) USER 


«m CODE FOR TR ANI^ER GOES HERE 


RUNJIOTAm: 




lUSER ASM CODE FOR ROTATE 00E8 HERE 



■fSi 



MCS«BASK>S2 



COMMAND/STATEMENT EXTENSIONS (VERSION 1.1 ONLY) 

Note that the oidinal position of the DATA WORDS in the user vector table must correspond to the token, 
so the user statement with the token lOH must be the first DW entry in &e vector table, IIH, the second, 
Hoc diird, and so on. The order of tokens in the user table is not impoc^Bt!! The following Ufgr 
kxdc^p table would function properly witib the previous example: 

EXAMPLE: 



> 

USER.TABLE: 








1 

DB 


13H 


1 THE TOKENS DO NOT 


HAVE 


DB 


'ROTATE' 


1 TO BE IN ORDER IN 


THE 


DB 


OOH 


I USER LOOKUP TABLE 




1 

I» 


lOH 






ra 


'DISPLAY' 






08 


OOH 


4 




1 

ra 


12H 






i» 


'TRANSFER' 






ra 


OFFH 


iEND OF TABLE 





A 



COMMAND/STATEIiiVrr ^e»®N® f¥lP^ON l Jl ONL¥) / V 

The user may also use the cominaad/statement extension option to re-define the syntax of MCS BASIC- 
Wi: this is done simply by placing your ov/n syntax in the user table and placing the appropriate BASI^ 
token in front of your re-defined keyword. A complete listing of all MCS BASlC-52 tokens and keywords 
aie provided in the back of this chapter. MCS BASIC-52 will always list out the program using the user 
Aftied systax, but it will still accept the standard keyword as a valid instruction. As m example, suppose 
that the user would like to substitute ttie keyword HEXOUT for PHl!,* Am the user wovM p«|^te &e 
following entry in the user table: 



USER_TABLE: 






i 

DB 

m 


SFH 

ocw 


J TOKEN FOR PHI. 

tTO BE IN ORDER IN THE 

»OSER LOOKUP TABLE 


m 

OB 

m 


lOH 

'0I8PLAV ' 




t 




.TABLE 




1 tND OF TABLE " 



MCS BASIC-52 will now accept the keyword HEXOUT and it will function in a manner identical to PHI. 
PHI. will still function correctly, however HEXOUT will be displayed when the user LIST a program. 
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COMMAND/STATEMENT EXTENSIONS (VERSION 1.1 ONLY) 



TOKEN 






TOKEN 


KEYWORD 


TOKEN 


KEYWORD 


80H 


LET 




vown 


ABS 


OECH 




6iH 


CI PAR 




OBIM 


IMT 


OEDH 


<> 


8SH 


PU^ 






S^ 


OEEH 


< 


83H 


WW 1 u 




voon 


wwl • 


Q}E!FW 




84H 


PMi 




0B4H 


CC^ 


OFOH 


RUN 


89H 








TAN 


(M^IH 


LIST 


86H 


UI 




OB6H 


SIN 


OF2H 


NULL 




1 Ifl 

WW 




0B7H 


SQR 


(M^3H 


NEW 


Dan 


pnp 

fur 




\ja on 




OP4M 
\j~ "rn 


CONT 


ROM 


PRTMT 




V/D Tn 


pyp 


wi «^n 


r fiuw 


ROM 


p 




ORAM 


ATM 
n 1 M 


OP AM 


yppQ 
Ar cn 


sou 


f \ VI. 1 


UPII.T / 


onnu 


1 no 

L.LIw 


ur /n 


RAM 


nAi4 








nnv 


i/r on 


RDM 

nun 


nnu 
oan 


n TM 




onni-i 


y R V 


\i~ Tn 


r ~nvJw 




QTR T 






P T 


nPAU— nppu 


MTiT 1 icurn 


nnu 


DAI tn 




ORPU 


RKin 






OCLJ 

oc.rl 






uuun 


tfC. 1 






or n 


PU1 

r n 1 . 




nr" 1 u 
1 n 


CD CP 














1 CKI 






Tin 


flKIT T MP 




vif on 


y TAi 












nPAU 


MTnp 
PI 1 Ur* 






Von 






v^^On 


X T MET 








nn 




U^rfOn 


T C 






TOM 


DPQTnOP 




wi* /n 


T D 






TOM 






or* OLJ 


T T MCDn 
1 infclKU 






T / n 


MPYT 




vt» Tn 


T T MPP 1 

1 1 nc.n 1 


-- 




9PM 

Ton 






AW 

\J\^ r\r\ 


T f MPRO 






TTn 


OKI 
un 






1 e\«Uni 






9AH 






nrru 


TfnM 






Ton 


RPAH 




utri/n 


TMnn 






Tvn 






nrPM 
uvfCin 


Pr AP9 






9DH 






U^*r n 


PnPT 1 






9EH 


IF 




ODOH 


PCON 






9FH 


GOSUB 




ODIH 


ASC< 






OAOH 


FOR 




0D2H 


USINO( 






OAIH 


WHILE 




ODSH 


U. ( 






0A2H 


UNTIL 




0D3H 


CHR< 






0A3H 


END 




OD4H-ODFH 


NOT USED 






0A4H 


TAB 




OEOH 


( 






0A9H 


THEN 




OEIH 


•« 






0A6H 


TO 




0E2H 


• 






OATH 


STEP 




0E3H 








OASH 


ELSE 




0E4H 


/ 






0A9H 






0E5H 








OAAH 


CR 




0E6H 


. XOR. 






OABH 


IDLE 




0E7H 


. AND. 






OACH 


STft (VI. 


1 ONLV> 


OEBH 


. OR. 






OADH 


LDC (Vt. 


1 ONLiri 


0E9H 


- (NEGATE) 






mm 


POH (VI. 


1 orC¥i 


OEAH 


m 








imOM(Vl. 


1 ONLY) 




>« 
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CHAPTER 13 
Mapping User Code Memory 



Keia might have noticed by now that some of external CODE memory locations that MCS BASIC-52 calls 
mM uses are located around 2000H and some of the locations are located around 4000H. Specifically, ttey 
are as follows: 

LOCAHON FUNCttON 

2001 H ON RESET. MCS BASlC-52 LOOKS FOR A OAAH IN THIS LOCATION, IF 

PRESENT, CALLS LOCATION 2090H 

2002H MCS BASIC-52 EXAMINES THIS LOCATION TO SEE IF THE USER 

WANTS TO IMPLEMENT THE COMMAND/STATEMENT EXTENSION OP- 
TION, A 05AH IS TO BE PLACED IN THIS LOCATION TO EVOKE THE 
COMIkAIM^CTENSION OPBON 

2048H MCS BASIC-52 CALLS THE LOCATION IF THE USER WANTS TO IMPLE- 

MENT THE COMMAND/STATEMENT EXTENSION OPTION. THE USER 
WILL USUALLY SET BIT 45 THEN RETURN. 

2070H MCS BASIC-52 CALLS THIS LOCATION TO GET THE USER VECTOR TA- 

BLE ADDRESS WHEN THE COMMAND/STATEMENT EXTENSION OP- 
TION IS EVOKED. THE ADDRESS OF THE VECTOR TABLE IS PUT IN 
THE DPTR BY THE USER. 

2078H MCS BASIC-52 CALLS THIS LOCATION TO GET THE USER LOOKUP TA- 

BLE ADDRESS WHEN THE COMMAND/STATEMENT EXTENSION OP- 
TION IS EVOKED. THE ADDRESS OF -mf^mmm W^HAB^^T IN 
THE DPTR BY THE USER. 

2090H MCS BASIC-52 CALLS THIS LOCATION WHEN THE USER EVOKES THE 

ASSEMBLY LANGUAGE RESET OPTION 

4003H EXTERNAL INTERRUPT 

400BH TIMER O INTERRUPT 

4013H EXTERNAL INTERRUPT 1 

401 BH TIMER mfmmp^ 

4023H SERIAL POWT INTERRUPT 

402BH TIMER 2 INTERRUPT 



4030H USER CONSOLE OUTPUT 

4033H USER CONSOLE INPUT 

4036H USER CONSOLE STATUS 

403CH USER PRINT® OR LIST® VECTOR 

41 OOH-41 FFH USER CALLS FORM TO 7FH 
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MAPPING USER CODE MEMORY 

Other vectors between 2040H and 20SpH als@ exist, but Oiey pajnli |^ testing purposes, but for your 
information they are: 

LOCATION FUNCTION 

2040H TRAP LOCATION FOR EXTERNAL INTERRUPT IF BIT 26H OF INTEI^- 

NAL RAM IS SET AND THE DMA OPTION IS EVOKED. PSW IS NOT 
PUSHED ONTO STACK. INTERRUPTS OF COURSE, MUST BE ENA- 
BLED. ALSO, THIS LOCATION WILL BE CALL50 FOB CONSOLE OUT- 
PUT IF BIT 2CH OF INTERNAL RAM IS SET. 

2050H TRAP LOCATION FOR SERIAL PORT INTERRUPT IF BIT 1FH OF INTER- 

NAL RAM IS SET. PSW IS PUSHED ONTO THE STACK. 

2060H CALLED FOR CONSOLE INPUT IF BIT 32H OF INTERNAL RAM IS SET. 

2068H CALLED FOR CONSOLE STATUS CHECK IF BIT 32H OF INTERNAL RAM 

; lis SET. 

2088H TIMER 1 INTERRUPT TRAP IF BIT 1 AH OF INTERNAL RAM IS SET. PSW 

IS PUSHED ONTO THE STACK. 

Contrary to popular belief, these vectors were not chosen to force the user to buy bigger EPROMS. They 
are chosen so that addresses 2000H and 4000H can be overlayed and create no conflicts. The Overlayed 
addresses would appear as 2001H, 2002H, 4003H, 400BH, 4013H, 401BH, 4023H, 402BH, 4030H, 
4033H, 4036H, 4039H, 2040H, 2048H, 2050H, 2060H, 2068H, 2070H, 2078H, 2088H, 2090H, and 
4100H thru 41FFH. The diagram on the next page illustrates how to implement overlapping addresses for 
2000H and 4000H. By using overlapping addresses, the user can implement all MCS BASIC-52 user 
expansion options With only a few htttidred bytes of EPROM. 

The reason this type of addressing scheme was chosen is that it permits the designer to offer custom 
versiom of MCS BASIC-52, by using the vector locations in the 2000H region. And give the designers 
OEM the ability to take advanta^ VO vectats located in the 4000H region. 

As an added note, the MCS-51 instruction set is object relocatable on 2K boundaries if no LCALL or 

LJMP instructions are used. This means that it is possible for the designer to ORG a program for 2000H 
and actually execute the program at 2800H, 3000H, 3800H, etc. If the user does not use the LCALL or 
LJMP instructions. 
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C1 



X" 



C2 

Ci = C2 
- 30pF 

FOR 

XTALS 

40 pF 

FOR 

CERAMIC 
RESONATORS 



PI .5 


PI. 4 


RST 












XTAL1 




P2.6 
P2.5 




P2.4 


XTAL2 






P2J3 




P2.2 




P2.1 




P2.0 




POJ 




P0.6 




P0.5 




P0.4 




P0.3 




P0.2 




P0.1 




P0.0 




W.3 


SERIAL 


MM 


IN 

SERIAL 
OUT 


m 

HD 
PSEN 
EA 

vcc 
am 




SI CLOSBi PROOUces ovaiLAPPiHB MMesses 

82 CLOSeOMMKTS ma TO BE W iMirat JogM MMIUOT 



Overlapping user EPROM address space 
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APPENDIX A 



1.1 MEMORY USAGE (Version 1.0) 

The following list specifies what locations in internal and external memory MCS BASIC-52 uses, and 
what these locations are used for. This information can largely be regarded as "for your information," 
but it can be used to do things like alter the pulse width of a EPROM {HOgtmuning pulse, etc. 

INTERNAL MEMORY ALLOCATION: 



LOCATION(S) IN HEX 

OOH THRU 07H 

08H 

09H 

OAH 

OBH THRU OFH 

10H 

11H 

12H 

13H 

14H 

15H 

16H 

17H 

18H THRU 21 H 



MCS BASIC-52 USAGE 

"WORKING REGISTER BANK" 

BASIC TEXT POINTER — LOW BYTE 

ARGUMENT STACK POINTER 

BASIC TEXT POINTER — HIGH BYTE 

TEMPORARY BASIC STORAGE 

READ TEXT POINTER — LOW BYTE 

CONTROL STACK POINTER 

READ TEXT POINTER — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — LOW BYTE 

NULL COUNT 

PRINT HEAD POSITION FOR OUTPUT 
FLOATING POINT OUTPUT FORMAT TYPE 
NOT USED — RESERVED FOR USER 



22H 



BITS USED SPECIFICALLY AS FOLLOWS 



BIT 22.0H 
BIT 22.1 H 
BIT 22.2H 
BIT 22.3H 
BIT 22.4H 
BIT 22.5H 
BIT 22.6H 
BIT 22.7H 



SET WHEN "ONTIME" STATEMENT IS EXECUTED 
SET WHEN BASIC INTERRUPT IN PROGRESS 
SET WHEN "0NEX1" STATEMENT IS EXECUTED 
SET WHEN "ONERR" STATEMENT IS EXECUTED 
SET WHEN "ONTIME" INTERRUPT IS IN PROGRESS 
SET WHEN A LINE IS EDITED 
SET WHEN EXTERNAL INTERRUPT IS PENDING 
WHEN SET, CONT COMMAND WILL WORK 



23H 



BITS USED SPECIFICALLY AS FOLLOWS 



BIT 23.0H 
BIT 23. 1H 
BIT 23.2H 
BIT 23.3H 
BIT 23.4H 
BIT 23.5H 
BIT 23.6H 
BIT 23.7H 



USED AS FLAG FOR "GET" OPERATOR 

SET WHEN INVALID INTEGER FOUND IN TEXT 

TEMPORARY BIT LOCATION 

CONSOLE OUTPUT CONTROL, 1 = LINE PRINTER 

CONSOLE OUTPUT CONTROL, 1 = USER DEFINED 

BASIC ARRAY INITIALIZATION BIT 

CONSOLE INPUT CONTROL, 1 = USER DEFINED 

RESERVED 
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1.1 MEMORY USAGE ' ^ 

INTERNAL MEMORY ALLOCATION: 

LO^TION(S) IN HEX MG^aASlG-^ USAOE ,^ 

24W BITS USED SPECIFICALLY AS FOLLOWS 

BIT 24.0H . STOP STATEMENT OR CONTROL-C ENCOUNTERED 

BIT 24.1 H = HEX INPUT, 1 = FP INPUT 

BIT 24.2H = RAM MODE, 1 = ROM MODE 

BIT 24.3H ZERO FLAG FOR DOUBLE BYTE COMPARE 

BIT24.4H SET WHEN ARGUMENT STACK HAS A VALUE '..^ 

BIT 24.5H , RETI INSTRUCTION EXECUTED 

BIT 24.6H ' RESERVED 

WT24.7H RESERVED 

25H BITS USED SPECIFICALLY AS FOLLOWS 

BIT 25.0H RESERVED, SOFTWARE TRAP TEST 

BIT 25.1 H FIND THE END OF PROGRAM, IF SET 

BIT 25.2H RESERVED 

BIT 25.3H INTERRUPT STATUS SAVE BIT 

BIT 25.4H SET WHEN PROGRAM EXECUTION IS COMPLETE 

BIT 25.5H RESERVED, EXTERNAL TRAP TEST 

BIT 2i5.6H SET WHEN CL0CK1 EXECUTED, ELSE CLEARED 

Bff iS.7H SET WHEN BASIC IS IN THE COMMAND MODE 

26H BITS USED SPECIFICALLY AS FOLLOWS 

BIT 26.0H SET TO DISABLE CONTROL-C 

BIT 26.1 H SET TO ENABLE "FAKE" DMA 

BIT 26.2H RESERVED 

BIT 26.3H SET TO EVOKE "INTELLIGENT" PROM PROGRAMMING 

BIT 26.4H SET TO PRINT TEXT STRING FROM ROM 

BTT 26.5H RESERVED 

BIT 26.6H SET TO SUPPRESS ZEROS IN HEX MODE PRINT 

BIT 26.7H SET TO EVOKE HEX MODE PRINT 
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1.1 MEMORY USAGE 

INTERNAL MEMORY ALLOCATION: 

LOCATION(S) IN HEX MCS BASIC-52 USAGE 



27H 

28H THRU 3DH 

3EH 

3FH 

40H 

41 H 

42H 

43H 

44H 

45H 

46H 

47H 

48H 

49H 

4AH 

4BH 
4CH 

4DH THRU OFFH 



"BIT" ADDRESSABLE BYTE COUNTER 

BIT AND BYTE FLOATING POINT WORKING SPACE 

INTERNAL STACK POINTER HOLDING REGISTER 

LENGTH OF USER DEFINED STRING — $ 

TIMER 1 RELOAD LOCATION — HIGH BYTE 

TIMER 1 RELOAD LOCATION — LOW BYTE 

BASIC TEXT POINTER SAVE LOCATION — HIGH BYTE 

BASIC TEXT POINTER SAVE LOCATION — LOW BYTE 

RESERVED 

TRANSCENDENTAL FUNCTION TEMP STORAGE 
TRANSCENDENTAL FUNCTION TEMP STORAGE 
MILLI-SECOND COUNTER FOR REAL TIME CLOCK 
SECOND COUNTER FOR REAL TIME CLOCK — HIGH 
BYTE 

SECOND COUNTER FOR REAL TIME CLOCK — LOW 
BYTE 

TIMER RELOAD FOR REAL TIME CLOCK 
SOFTWARE SERIAL PORT BAUD RATE — HIGH BYTE 
SOFTWARE SERIAL PORT BAUD RATE — LOW BYTE 
8052AH STACK SPACE AND USER WORKING SPACE 
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1.1 MEMORY I^A®t 

EXTERNAL MEMORY ALLOCATION 

LCI6ATI0N(S) IN HEX MCS BASIC-52 USAGE 



OOH AND 01 H 
02H AND 03H 
04H 

Om AND 06H 

07H THRU 49H T • . 

50H THRU 5FH 

60H THRU OFEH 

OFFH 

100H 

101H 

102H AND 103H 

104H AND 105H 

106H AND 107H 

108H AND 109H 

10AH AND 10BH 

10CHAND10DH 

10EH THRU 113H 

114H THRU 11 FH 

120H AND 121H 

122HAND123H > i 

124H THRU 127H 

128H AND 129H 

12AH AND 12BH 

12CH 

12DH THRU 1FEH 



"LAST" END OF FILE ADDRESS FOR RAM FILE (H-L) 

CURRENT END OR FILE ADDRESS FOR RAM «LE (H-4|i 

LENGTH OF THE CURRENT EDITED LINE 

LN NUM IN BINARY OF CURRENT EDITED LINE (H-L) 

BASIC INPUT BUFFER 

FLOATING POINT OUTPUT TEMP 

CONTROL STACK u 
CONTROL STACK OVERFLOW 
LOCATION TO SAVE "GET" CHARACTER 
LOCATION TO SAVE ERROR CHARACTER CODE 
LOCATION TO GO TO ON USER "ONERR" (H-L) 
TOP OF VARIABLE STORAGE (H-L) 

FP STORAGE ALLOCATION (H-L) ■ j 

MEMORY ALLOCATED FOR MATRICES (H-L) 
TOP OF MEMORY ASSIGNED TO BASIC (H-L) 
RANDOM NUMBER SEED 
CRYSTAL VALUE 
FLOATING POINT TEMPS 

LOCATION TO GO TO ON 0NEX1 INTERRUPT (H-L) 
NUMBER OF BYTES ALLOCATED FOR STRINGS (H-L) 
ONTIME INTERRUPT AND LINE NUMBER (H-L) 
"NORMAL' PROM PROGRAMMER TIME OUT (H-L) 
"INTELLIGENT" PROM PROGRAMMER TIME OUT (H-L) 
RESERVED 
ARGUMENT STACK 



NOTE: (H-L) means HIGH BYTE — LOW BYTE, in external memory all 16 bit binary numbers 
are stored with the HIGH BYTE in the first (lower ordesc) address and the LOW BYTE in the 
oext sequential address. 
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1.1 MEMORY USAGE (VERSION 1.1) 

The following list specifies what locations in internal and external memory locations are used tlty'Vigr^M 
1.1 of MCS BASIC-52. Any differences between Vl.O and Vl.l are in bold face type. 

INTERNAL MEMORY ALLOCATION: (VERSION 1.1) 



LOCATION(S) IN HEX 

OOH THRU 07H 

08H 

09H 

OAH 

OBH THRU OFH 

10H 
11H 
12H 
13H 
14H 
15H 
16H 
17H 

18H THRU 21 H 



MCS BASiO-52 USAGE 

"WORKING REGISTER BANK" 

BASIC TEXT POINTER — LOW BYTE 

ARGUMENT STACK POINTER 

BASIC TEXT POINTER — HIGH BYTE 

TEMPORARY BASIC STORAGE (Available to user in BAilC 

CALLS to ASM routines) 

READ TEXT POINTER — LOW BYTE 

CONTROL STACK POINTER 

READ TEXT POINTER — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — LOW BYTE 

NULL COUNT 

PRINT HEAD POSITION FOR OUTPUT 
FLOATING POINT OUTPUT FORMAT TYPE 
NOT USED — RESERVED FOR USER 



22H 



BITS USED SPECIFICALLY AS FOLLOWS 



BIT 22.0H 
BIT 22.1 H 
BIT 22.2H 
BIT 22.3H 
BIT 22.4H 
BIT 22.5H 
BIT 22.6H 



SET WHEN "ONTIME" STATEMENT IS EXECUTED 
SET WHEN BASIC INTERRUPT IN PROGRESS 
SET WHEN "0NEX1" STATEMENT IS EXECUTED 
SET WHEN "ONERR" STATEMENT IS EXECUTED 
SET WHEN "ONTIME" INTERRUPT IS IN PROGRESS 
SET WHEN A LINE IS EDITED 
SET WHEN EXTERNAL INTERRUPT IS PENDING 
mm SET, 031^ COMMAND WILL WORK 



23M 



BITS USED SPECIFICALLY AS FOLLOWS 



BIT 23.0H 
BIT 23.1 H 
BIT 23.2H 
BIT 23.3H 
BIT 23.4H 
BIT 23.5H 
BIT 23.6H 
BfT^.7H 



USED AS FLAG FOR "GET" OPERATOR 
SET WHEN PRINT® OR LIST® IS EVOKED 
RESERVED, TRAPS TIMER 1 INTERRUPT 
CONSOLE OUTPUT CONTROL, 1 = LINE PRINTER 
CONSOLE OUTPUT CONTROL, 1 =USER DEFINED 
BASIC ARRAY INITIALIZATION BIT 
CONSOLE INPUT CONTROL, 1 = USER DEFINED 
RESERVED, USED TO TRAP SERIAL PORT INTERRUPT 



m 
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INTERNAL MEMORY ALLOCATION (VERSION 1.1) 
LOCATION(S) IN HEX MGS BASIOSa USAGE 



24H 

BIT 24.0H 
BIT 24.1 H 
BIT 24.2H 
BIT 24.3H 
BIT 24.4H 
BIT 24.5H 
BIT 24.6H 
BIT 24.7H 



25H 

BIT 25.0H 
BIT 25.1 H 
BIT 25.2H 
BIT 25.3H 
BIT 25.4H 
BIT 25.5H 
BIT 25.6H 
BIT 25.7H 

26H 

BIT 26.0H 
BIT 26.1 H 
BIT 26.2H 
BIT 26.3H 
BIT 26.4H 
BIT 26.5H 
BIT 26.6H 
BIT 26.7H 



■J.-' r J/ jct I 



BITS USED SPECIFICALLY AS FOLLOWS 

STOP STATEMENT OR CONTROL-C ENCOUNTERED 
USER IDLE BREAK BIT ir 
SET DURING AN INPUT INSTRUCTION 
RESERVED 

SET WHEN ARGUMENT STACK HAS A VALUE 
RETI INSTRUCTION EXECUTED . . .. 

RESERVED, TRAPS EXTERNAL INTERRUPT ^ ^ 

SET BY USER TO SIGNIFY THAT A VAUD LI$T@ OR . r 
PRINT® DRIVER IS PRESENT > 

8 USED SPECIFICALLY AS P^Jjeii® 

RESERVED, SOFTWARE TRAP TEST 

FIND THE END OF PROGRAM, IF SET 

SET DURING A DIM STATEMENT 

INTERRUPT STATUS SAVE BIT 

RESERVED, INPUT TRAP 

SET TO SIGNIFY EXPANSION IS PRESENT 

SET WHEN CL0CK1 EXECUTED, ELSE CLEARED 

SET WHEN BASIC IS IN THE Q^MAND MODE 

BITS USED SPECIFICALLY AS FOLLOWS 

SET TO DISABLE CONTROL-C 
SET TO ENABLE "FAKE" DMA 
RESERVED, OUTPUT TRAP 

SET TO EVOKE "INTELLIGENT" PROM PROGRAMMING 

SET TO PRINT TEXT STRING FROM ROM 

SET WHEN CONTROL-S ENCOUNTERED 

SET TO SUPPRESS ZEROS IN HEX MODE PRINT 

SET EVOKE HEX MODE PRtilT 
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INTERNAL MEMORY ALLOCATION (VERSION 1.1) * 

LOCATION(S) IN HEX MCS BASIO€2 USAGE 

27H "BIT" ADDRESSABLE BYTE COUNTER 

28H THRU 3DH BIT AND BYTE FLOATING POINT WORKING SPACE 

3EH INTERNAL STACK POINTER HOLDING REGISTER 

3FH LENGTH OF USER DEFINED STRING — $ 

40H TIMER 1 RELOAD LOCATION — HIGH BYTE 

41 H TIMER 1 RELOAD LOCATION — LOW BYTE 

42H - BASIC TEXT POINTER SAVE LOCATION — HIGH BYTE 

43H BASIC TEXT POINTER SAVE LOCATION — LOW BYTE 

44H RESERVED 

45H TRANCENDENTAL FUNCTION TEMP STORAGE 

46H TRANCENDENTAL FUNCTION TEMP STORAGE 

47H MILLI-SECOND COUNTER FOR REAL TIME CLOCK 

48H SECOND COUNTER R)R REAL TIME CLOCK — HIGH 

BYTE 

49H SECOND COUNTER FOR REAL TIME CLOCK — LOW 

BYTE 

4AH TIMER RELOAD FOR REAL TIME CLOCK 

4BH USER ARGUMENT FOR ONTIME — HIGH BYTE 

4CH USER ARGUMENT FOR ONTIME — LOW BYTE 

4DH THRU OFFH 8052AH STACK SPACE AND USER WORKING SPACE 
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EXTERNAL MEMORY ALLOCATION (VERSION 1.1) 



LOCATION(S) IN HEX 


MCS BASIC-52 USAGE 


OOH THRU 03H 


NOT USED, RESERVED 


04H 


LENGTH OF THE CURRENT EDITED LINE 


05H AND 06H 


LN NUM IN BINARY OF CURRENT EDITED LINE (H-L) 


07H THRU 56H 


BASIC INPUT BUFFER 


56H THRU SDH 


BINARY TO INTEGER TEMP 


5EH 


USED FOR RUN TRAP MODE (= 34H) 


5FH 


USED FOR POWER-UP TRAP ( = 0A5H) 


enu TUail QFEH 


CONTROL STACK ^ 


OOFH 


CONTROL STACK OVERFLOW 


100H 


LOCATION TO SAVE "GET" CHARACTER 


101H 


LOCATION TO SAVE ERROR CHARACTER CODE 


102H AND 103H 


LOCATION TO GO TO ON USER "ONERR" (H-L) 


104H AND 105H 


TOP OF VARIABLE STORAGE (H-L) 


106H AND 107H 


FP STORAGE ALLOCATION (H-L) 


108H AND 109H 


MEMORY ALLOCATED FOR MATRICIES fH-L) 

1 V 1 V 1 lit ' 1 Iv^V^^ t \ 1 1 III V If 1 1 1 1 1 1 1^^^ II 1 1 


10AH AND 10BH 


TOP OF MEMORY ASSIGNED TO BASIC (H-L) 


lOCH AND 10DH 


RANDOM NUMBER SEED (H-L) 


10EHTHRU113H 


CRYSTAL VALUE 


114H THRU 11FH 


FLOATING POINT TEMPS 


120HAND 121H 


LOCATION TO GO TO ON 0NEX1 INTERRUPT (H-L) 


122H AND 123H 


NUMBER OF BYTES ALLOCATED FOR STRINGS (H-L) 


124H AND 125H 


SOFTWARE SERIAL PORT BAUD RATE (H-L) 


126H AND 127H 


LINE NUMBER FOR ONTIME INTERRUPT (H-L) 


128H AND 129H 


"NORMAL" PROM PROGRAMMER TIME OUT (H-L) 


12AH AND 12BH 


"INTELLIGENT" PROM PROGRAMMER TIME OUT (H-L) 


12CH 


RESERVED 


12DHTHRU 1FEH 


ARGUMENT STACK 



NOTE: (H-L) still means HIGH BYTE — LOW BYTE, in external memory all 16 bit binary numbers 
are stored with the HIGH BYTE in the first (lower order) address and tiie LOW BYTE in the next sequential 
address. 
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1.2 USING THE PWM STATEMENT 

The PWM statement can be used to generate quite accurate frequencies. The following table lists the reload 
values 8 octaves of an equal tempered chromatic scale. The reload values are for the first two arguments 
of the PWM statement, so it is assumed that a square wave is being generated. The reload values assuaie 
a 11.0592 MHz crystal. 
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4189 
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116.540 
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3954 


0F72H 


B 


2 


123.470 


123.472 


3732 


0E94H 


C 


3 


130.812 


130.798 


3523 


0DC3H 


C# 


3 


138.592 


138.586 


3325 


OCFDH 


D 


3 


146.832 


146.845 


3138 


0C42H 


D# 


3 


155.564 


155.570 


2962 


0B92H 


E 


3 


164.812 


164.807 


2796 


OAECH 


F 


3 


174.616 


174.612 


2639 


0A4FH 


F# 


3 


184.996 


184.986 


2491 


09BBH 


G 


3 


195.996 


196.001 


2351 


092FH 


G# 


3 


207.652 


207.661 


2219 


08ABH 


A 


3 


220.000 


219.952 


2095 


082FH 


A# 


3 


233.080 


233.080 


1977 


07B9H 


B 


3 


246.940 


246.946 


1866 


074AH 
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IDEAL 


ACTUAL 




HEX 


iMi.. 


OCTAVE 


FflEGtUiilCY 


]PRSQUEN@Y 


iRELOA9 


. RELOAD 


c 


4 


261 .624 


261 .669 


1761 


06E1H 


c# 


4 


277.184 


277.256 


1662 


067EH 


D 


4 


293.664 


293.690 


1569 


0621 H 


D# 


4 


311.128 


311.141 


1481 


05C9H 


E 


4 


329.624 


329.614 


1398 


0576H 


F 


4 


349.232 


349.355 


1319 


0527H 


F# 


4 


369.992 


370.120 


1245 


04DDH 


G 


4 


391.992 


391 .836 


1176 


0498H 


G# 


4 


415.304 


415.135 


1110 


0456H 


A 


4 


440.000 


440.114 


1047 


041 7H 


A# 


4 


466.160 


465.925 


989 


03DDH 


B 


4 


493.880 


493.890 


933 


03A5H 


C 


5 


523.248 


523.042 


881 


0371 H 


C# 


5 


554.368 


554.512 


831 


033FH 


D 


5 


587.238 


587.006 


785 


031 1H 




5 


622.256 


621.8^ 


741 


02ESW 


E 


5 


659.248 


659.228 


699 


02BBH 


F 


5 


698.464 


698.182 


660 


0294H 


f#' 


5 


739.984 


739.647 


623 


G2&m 


G 


5 


783.984 


783.674 


588 


024CH 


G# 


5 


830.608 


830.270 


555 


022BH 


A' 


5 


880.00Q 


879.389 


524 


020Gt# 


A# 


5 


932.320 


932.793 


494 


01EEH 


B 


5 


987.760 


986.724 


467 


01D3H 


C 


6 


1046.496 


1047.272 


440 


01B8H 


C# 


6 


1108.736 


1107.692 


416 


01A0H 


D 


6 


1174.656 


1175.510 


392 


0188H 


m 


6 


1244.512 


1245.405 


370 


017^ 


E 


6 


1318.496 


1320.343 


349 


015DH 


F 


6 


1396.928 


1396.364 


^0 


014AH 


F# 


6 


1479.968 


1481.672 


311 


0137H 


G 


6 


1567.968 


1567.347 


294 


0126H 


G# 


6 


1661.216 


1663.538 


277 


0115H 


A 


6 


1760.000 


1758.779 


232 


01 §#4 


A# 


6 


1864.640 


1865.587 


247 


00F7H 


B 


6 


1975.520 


1977.682 


233 


00E9H 
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IDcAL 


A ^Tl 1 A 1 

AwTUAL 




ncX 




OCTAVc 


rncQUcNCY 


rHcUUclMUT 


DEI r\Ar% 
KbLUAU 


Reload 




7 


2092.992 


2094. o4o 


220 


OODUH 


c# 


7 


00 H "7 il TO 

221 7.472 


2215.385 


208 


oon\oi_i 

OODOH 


D 


— • 

7 


2349.31 2 


00 e 4 oo/\ 

2351 .020 


196 


00C4n 


r% MM 

D# 


7 


2489.024 


2490.81 1 


185 


00B9H 


1 — 
c 


7 


2636.992 


2633.143 


175 


OOAFH 


r~ 

r 


7 


2793.856 


rt-yOO TO"T 

2792.727 


165 


OOASH 


r# 


7 


2959.936 


00 CO 0-4 

2953.846 


156 


OOft/^l_l 

009CH 


G 


7 


3135.936 


3134.694 


147 


0093H 


^ -U. 

G# 


7 


3322.432 


3315.108 


139 


008BH 


A 

A 


7 


3520.000 


3517.557 


131 


00001 1 

0083H 


A -U. 

A# 


7 


3729.280 


"7 4 4 00 

3716.129 


124 


007CH 


B 


7 


3951 .040 


0000 

3938.362 


117 


0075H 


C 


8 


4185.984 


j| 4 00 004 

4189.091 


110 


006EH 


c# 


8 


4434.944 


4430.770 


104 


0068H 


D 


8 


4698.624 


4702.041 


98 


0062H 


D# 


8 


4987.048 


5008.695 


92 


005CH 


E 


8 


5273.984 


5296.552 


87 


0057H 


F 


8 


5587.712 


5619.512 


82 


0052H 


F# 


8 


5919.872 


5907.692 


78 


004EH 


G 


8 


6217.872 


6227.027 


74 


004AH 


G# 


8 


6644.864 


6678.261 


69 
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A 


8 


7040.000 


7089.231 


65 


0041 H 


A# 


8 


7458.560 


7432.258 


62 


ooaiH 


B 


8 


7902.080 


7944.827 


58 


003AH 
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1.2 USING THE PWM STATEMENT -r^ f 

The following program generates the appropriate reload values for the PWM statement, using any crystal. 
Tii^aser enters die desired frequency and the crystal and the program detemuned the reload va 



>10 INPUT "ENTER CRYSTAL FREQUENCY - X 










:>20 T=12/X 










;>30 INPUT "ENTER DESIRED FREQUENCY FOR PWM - 


". F 








>40 Ft=l/F 










:>50 C = (Fl/T)/2 : REM CALCULATE RELOAD VALUE 










;'60 IF C<20 THEN 30 










>70 C1=C-INT(C) : REM CALCULATE FRACTION 










>80 IF CK. 5 THEN 90 : C=C + 1 


K 








>90 PRINT ; PRINT "THE DESIRED FREQUENCY IS - 




"HZ" 






MOO C = INT<C) : PRINT 








MIO PRINT "THE ACTUAL FREQUENCY IS - ", 1/(2»C»T), 


"HZ" 






M20 PRINT 










>130 PRINT "THE RELOAD VALUE FOR PWM IS - ".C 


, " IN 


HEX - ". 


PHI. C 




;>140 INPUT "ANOTHER FREQUENCY. I'YES. 0=NO - 


".Q 








MSG IF Q=l THEN 20 
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1.3 BAUD RATES AND CRYSTALS 

The 16 bit auto-reload timer/counter (TIMER2) that is used to generate baud rates for the MCS BASIC-S2 
device is capable of generating accurate baud rates with a number of crystals. The following is a list of 
crystals that will accurately generate 9600 baud on the MCS BASlC-52 device. AdditionaUy, tihe crystal 
values on the left hand side of the table will accurately generate 19200 baud. 



XTAL 


RCAP2 RiLOAD 


XTAL 


RCAP2 HiLOAg! 

i 


3680400 


65524 


3993600 


65523 


4300800 


65522 


4608000 


65521 


4915200 


65520 


5222400 


65519 


5529600 


65518 


5836800 


65517 


6144000 


65516 


6451200 


65515 


6758400 


65514 


7065600 


65513 


7372800 


65512 


7680000 


65511 


7987200 


65510 


8294400 


65509 


8601600 


65508 


8908800 


65507 


9216000 


65506 


9523200 


65505 


9830400 


65504 


10137600 


65503 


10444800 


65502 


10752000 


65501 


11059200 


65500 


11366400 


65499 


11673600 


65493 


11980800 


65497 



With the crystals listed above, the accuracy of the baud rate generator and the REAL TIME CLOCK wiU 

depend ONLY on the absolute accuracy of the crystal. Note that the baud rate generator for the 8052AH 
is so accurate that any crystal above 10 MHz will generate 9600 baud to within 1.5% accuracy. 
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1.3 BAUD RATES AND CRYSTALS 

The following program generates the appropriate T1MER2 reload values for a given baud rate. The user 
supplies the system clock frequency and the desired baud rate and the program calculates the proper 
TIMER2 reload value. Additionally, percent error, for both toe laatftiWiiBeia^ and MCS BASKI^O^ 
REAL TIME CLOCK are calculated and displayed. 



>10 INPUT"ENTER CRYSTAL - ", X 

>20 INPUfENTER BAUD RATE - g, jl»-'>a "^.^» i 

>30 R«X/<32»B): T-X/76B00 ^' ^ ' 

>40 R l-R- INT < R ) : T i»T- WT< Tl 
>S0 IF RK. S THEN 

:>60 R1=1-R1 aikVJiqTe'j 
>70 R-R+1 ^ ^ 

>B0 IF TK. a THEN ll® 
>90 Tl-l-Tl 
MOO T=T+l 

>110 PRINT "TIMER2 RELOAD VALUE IS - USING <#«###«). INT (65336-R ) 
>120 PRINT "BAUD RATE ERROR IS - ". USINe< tttt. »««) . <R1/R )*100. 
>130 PRINT "REAL tlWl CLOCK ERROR IS - " (Tl/T»*100, "X" 



I". I fT»*>pO^'l . 



T.-!.?ir( 
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1.4 QUICK REFERENCE 
COMMANDS: 

COMMAND FUNCTION 



RUN 

CONT 

LIST 

LIST# 

LIST® 

NEW 

NULL 

RAM 

ROM 

XFER 

PROG 
PR0G1 



PROi^ 
PROQ4 



Execute a program 

COtmiiis after a STOP or control-C 

LIST program to the console device 

LIST program to serial printer 



LIST program to user driver (version 1.1 
only) 

erase tiie program stored In RAM 

set NULL count after carriage return- 
line feed 

evoke RAM mode, current program in 
READ/WRITE memory 

evoke TOM mode, current program in 
ROMIiiROM memory 

transfer a program from ROM/EPROM to 
RAM 

save the current program in EPROM 

save baud rate information in EPROM 

save baud rate information in EPROM 
and execute program after RESET 

save baud rate and IVITOP infomiation In 
EPROM (version 1.1 only) 

save baud rate and MTOP information in 
EPROM and execute program after 
RESET (version 1.1 only) 



EXAMPLE(S) 

RUN 

CONT 

LIST 

LIST 10-50 

LIST# 
LIST# 50 

LIST® 
LIST® 50 

NEW 

NULL 
NULL 4 

RAM 



ROM 
ROMS 

XFER 



PROG 

PR0G1 

PR0G2 



PR0G3 
PR0G4 
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1.4 QUICK REFERENCE 



COMMANDS: 
COMMAND 

PR0G5 



PR0Q6 

FPROG 

FPR0G1 

FPROG2 

FPR0G3 

FPROG4 

FPR0G5 

FFWD@6 



FUNCTION 

same as PR0G4 except that external 
RAM is not cleared on RESET or power 
up if external RAM contains a 0A5H in 
tm^dion (version 1 .1 only) 

same as PR0G6 except tliat external 
code location 4039H Is CALLED after 
RESET (version 1.1 only) 

save the current program in EPROM 
using the INTELIigent algorithm 

save baud rate information in EPROM 
using the INTELIigent algorithm 

save baud rate information in EPROM 
£Uid execute program after RESET, use 
ifflUtgent algoHtftn 

same as PR0G3, except INTELIigent 
programming algoritlim is used (version 
1.1 only) 

same as PR0G4, except INTELIigent 
programming EUgoritfim is used (version 
1.1 only) 

same as PROGS, except INTELIigent 
programming algoritlim is used (version 
1.1 only) 

same as PR0G6, except INTELIigcHit 
programming algorithm is used (version 
1.1 only) 



EXAMPLE(S) 
PROGS 



PROG6 

FPROG 

FPR0G1 

FPROG2 

FPR0G3 

FPR0G4 

FPR0G5 

FPreX36 
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1.4 QUICK REFERENCE 
STATEMENTS: 



STATEMENT 


FUNCTION 


EXAMPLE(S) 


BAUD 


set baud rate for line printer port 


BAUD 1200 


CALL 


CALL assemNy language pr^grsun 


CALL 9000H 


CLEAR 


CLEAR variables, interrupts and Swings 


CLEAR 


CLEARS 


CLEAR Stacks 


CLEARS 


CLEARI 


CLEAB Interrupts 


CLEARI 


CLOCK1 


enable REAL TIME CLOCK 


CL0CK1 


CLOCKO 


disable REAL TIME CLOCK 


CLOCKO 


DATA 


DATA to be read by READ statement 


DATA 100 


READ 


READ data in DATA statement 


READ A 


RESTORE 


RESTORE READ pointer 


RESTORE 


DIM 


allocate memory for arrayed variably 


^VIK M A /MAX 

DIM A(20) 


DO 


set up loop tor WHILE or UNTIL 


DO 


UNTIL 


test DO loop condition (loop if false) 


UNTIL A= 10 


WHILE 


test DO loop condition (loop if true) 


WHILE A=B 


END 


terminate program execution 


END 


FOR-TO-{STEP} 


set up FOR-NEXT loop 


FOR A=1 TO 5 


NEXT 


test FOR-NEXT loop condition 


NEXT A 



Intel 



MCS® BASIC-52 



1.4 QUICK REFERENCE 

STATEMENTS: 



eosuB 

RETURN 
QOTO 
ON GOTO 

ON GOSUB 

IF-THEN-{ELSE} 

ilSirUT 
LET 

ONERR 
ONTIME 

0NEX1 
PRINT 

pefNT# 

PHO. 
PHI. 

PHt).# 
PH1.# 



PUNCTIGN ^' 

execute subroutine 
RETURN from subroutine 
GOTO program line number 

iWWiittonal GOTO fM<» 

ienditional GOSUB 
conditional test 



INPUT a ^Hiig or varli^ ^ 

assign a variable or string a value 
fUlT Is optional) 

ONERRor GOTO line number 

generate an interrupt when TIME is equal 
to or greater tiian ONTIME argument-line 
number is after comma 

GOSUB to line number following 0NEX1 
when INT1 pin.ls puM^ tew 

PRINT variables, strings or literals 
R is siiortiiand for PRINT 

PRINT to software serial port 

PRINT HEX mode with zero suppressips 

PRINT HEX mode with no zero 
suppression 

PHO. to Hne printer > 
PH1.#to line printer 



• -, *■ 

EXAIIPLE(S) g 

GOSUB 10QiSB<i 

RETURN 

GOTO 500 

ON A GOTO S, 
20 

ON A GOSUB 2, 
6 

IF A<8 THEN 
A=0 ' 

INPUT A 

LETA=10 

ONERR 1000 
ONTIME 10, loot 

0NEX1 1000 

PRINT A 

PRiNT# A 
PHO. A 
PHI. A 

PHO.# A 
PH1.# A 
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1.4 QUICK REFERENCE 
STATEMENTS: 



STATEMIIIT 


FUNCTION 


EXAMPIXP) 


PRINT® 


PRINT to user defined driver (version 1 .1 
only) 


PRINT® 5*5 


PHO.@ 


PHO. to user defined driver (version 1.1 


PHO. @ 
XBY(5EH) 


PH1.@ 


PH1 . to user defined driver (veraioii 1.1 
only) 


PH1.@A 


PGM 


Program an EPROM (^rsion 1.i only) 


PGM 


PUSH 


PUSH expressions on argument stack 


PUSH 10, A 


POP 


POP argument stack to variables 


POP A, B, 


PWM 


PULSE WIDTH MODULATION : 


PWM 50, 50, 11 


REM 


REMarl< 


REM DONE 


RETI 


RETum from Interrupt 


RETI 


STOP 


break program execution 


STOP 


STRING 


allocate memory for STRINGS 


STRING 50, 10 


UI1 


evoke User console Input routine 


UI1 


UIO 


evoke BASIC eomote input routfne 


UIO 


U01 


evoke User console Output routine 


U01 


UOO 


evoke BASIC console Output routine 


UOO 


ST@ 


store top of stack at user specified 
location (version 1.1 only) 


ST@ 1000H 
ST@ A 


LD@ 


load top of stack from user specified 
location (version 1.1 only) 


LD@ 1000H ' 
LD® A 


IDLE 


wait |i>r|Merrupt (version 1.1 on^) 


IDLE 1 • 


RROM 


run a program In EP(ROM) (version 1.1 


RROM 3 



only) 
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1.4 QUICK 

OPERATORS 
OPiRAfOfl 



REFERENCE 

— DUAL OPERAND: 
ACTION 



.OR. 
.XOR. 

OPiRATORS 

ABS() 

NOT() 

INTO 

S@N() 

SQR() 

RND 

LOGO 

EXPO 

SINO 

COS( ) 

TAN( ) 

ATN() 



•Ji.i 



AOdmoN 

DIVISION 
©CPQNENTATION 
MULTIPLICATION 
SUBTRACTION 
LOGICAL AND 
LOGICAL OR 
LOGICAL EXCLUSIVE OR 
— SINGLE OPERAND: 

ABSOLUTE VALUE 
ONES COMPLEMENT 
INTEGER 
SIGN 

SQUARE ROOT 

RANDOM NUMBER 

NATURAL LOG 

"e" (2.7182818) TO THE X 

RETURNS THE SINE OF ARGUMENT 

RETURNS THE COSINE OF 
ARGUMENT 

RETURNS THE TANGENT OF 
ARGUMENT 

RETURNS ARCTANGENT OF 
ARGUMENT 



EXAIiPLE(S) 

1 + 1 

10/2 

2**4 

4*4 

8-4 

10.AND.5 
2.0R.1 

3.XOR.2 

ABS(-3) 

NOT(O) 

INT(3.2) 

S6N(-5) 

SQR(IOO) 

RND 

LOG(10) 

EXP(IO) 

SIN(3.14) 

COS(0) 

TAN(.707) 

ATN(1) 
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1.4 QUICK REFERENCE 
OPERATORS — SPECIAL FUNCTION: 



CBY() 
DBY( ) 

XBY() 

GET 

IE 

IP 

PORT1 

PCON 

RCAP2 

T2C0N 

TOON 

TMOD 

TIME 

TIMERO 

TIMER1 

TIMER2 

STORED CONSTANT: 

PI 



READ PROGRAM MEMORY 

READ/ASSIGN INTERNAL DATA 
MEMORY 

READ/ASSIGN EXTERNAL DATA 
MEMORY 

READ CONSOLE 

READ/ASSIGN IE REGISTER 

READ/ASSIGN IP REGISTER 

READ/ASSIGN I/O PORT 1 (P1) 

READ/ASSIGN PCON REGISTER 

READ/ASSIGN RCAP2 
(RCAP2H:RCAP2L) 

READ/ASSIGN T2C0N REGISTER 

READ/ASSIGN TCON REGISTER 

READ/ASSIGN TMOD REGISTER 

READ/ASSIGN THE REAL TIME CLOCK 

READ/ASSIGN TIMERO (THO: TLO) 

READ/ASSIGN TIMER1 (TH1: TL1) 

READ/ASSIGN TIMER2 (TH2: TL2) 



PI - 3.1415926 



R CBY(400Q) 

DBY(99) = 10 

R XBY(I O) 

R GET 
IE = 82H 
IP=0 

PORT1=0FFH 

PCON=0 

RCAP2=i100 

R T2C0N 
TCON = 10H 
R TMOD 
R TIME 
TIMERO = 
R TIMER1 
TIMER2 = 0FFH 

PI 



-lOTVl-Cnv 
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1.5 INSTRUCTION SET SUMMARY aM«0«? M 



COMMANDS 


STATEMENTS 


OPERATORS 


RUN 


BAUD 


ADD( + ) 


CONT 


CALL 


si«iiv> DIVIDE (/) 


LIST 


CLEAR 


EXPONENTIATION (") 


LIST# 


CLEAR(S&[) 


MULTIPLY (*) 


LIST® (V1.1) 


CLOCK(1&0) 


SUBTRACT (-) 


NEW 


DATA 


LOGICAL AND (.AND.) 


NULL '■■■^ 


READ 


LOGICAL OR (.OR.) 


RAM 


RESTORE 


LOGICAL X-OR (.XOR.) 


ROM 


DIM 


LOGICAL NOT (.OR.) 


XFER 


DO-WHILE 


ABS() 


PROG 


DO-UNTIL 


INTO 


PROG1 


END 


SGN() 


PROG2 


FOR-TO-STEP 


SQR() 


PR0G3 (V1.1) 


NEXT 


i V . . RND 


PR0G4 (V1.1) 


GOSUB 


LOGO 


PROGS (VI. 1) 


RETURN 


EXPO 


PR0G6 (V1.1) 


GOTO 


SINO 


FPROG 


ON-GOTO 


COS() 


FPR0G1 


ON-GOSUB 


TAN() 


FPROG2 


IF-THEN-ELSE 


' . ■- . ATN() 


FPR0G3 (V1.1) 


INPUT 


= , >, > = , <, < = , <> 


FPR0G4 (V1.1) 


LET 


ASCO t 


FPR0G5 (VI. 1) 


ONERR 


CHR( ) 


FPR0G6(V1.1) 


0NEX1 


CBY() 




ONTIME 


DBY() 




PRINT 


XBY() 




PRINT# 


GET 




PRINT® (V1.1) 


IE 




PHO. 


IP 




• PHO.# 


P0RT1 




PHO.® (V1.1) 


PCON 




PH1. 


RCAP2 




PH1.# 


T2C0N 




PH1.@ (VI. 1) 


TCON 




PGM (V1.1) 


TMOD 




PUSH 


TIME 




POP 


TIMERO 




PWM 


TIMER1 




REM 


TIMER2 




RET! 


XTAL 




STOP 


MTOP 




STRING 


LEN 




Ul(1&0) 


FREE 




U0(1&0) 


PI 




LD@ (V1.1) 






ST® (V1.1) 






IDLE (VI. 1) 






mm(y^.^) 
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1.6 FLOATING POINT FORMAT 

MCS BASIC-52 stores all floating point numbers in a normalized packed BCD format with an offset binary 
exponent. The simplest way to demonstrate the floating point format is to use an example. If the number 
PI (3.1415926) was stored in location X, the following would ^pear in memory. 

LOCATION VALUE DESCRIPTION 

X 81 H EXPONENT — 81 H = 10**1, 82H = 10**2, 

80H = 10**0, 7FH = 10**-1 etc. 

THE NUMBER ZERO IS REPRESENTED WITH A 

ZERO EXPONENT 

X-1 OGH SIGN BIT — OOH = POSITIVE, 01 H = NEGATIVE OTHER BITS ARE 

USED AS TEMPS ONLY DURING A CALCULATION 



X-2 


26H 


LEAST SIGNIFICANT TWO DIGITS 


X-3 


59H 


NEXT LEAST SIGNIFICANT TWO DIGITS 


X-4 


41 H 


NEXT MOST SIGNIFICANT TWO DIGITS 


X-5 


31 H 


MOST SIGNIFICANT TWO DIGITS 



Because MCS BASIC-S2 ncnmalizes all numb^, the most significant digit is never a zero unless ttle 
Bumb« is tern. 
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1.7 STORAGE ALLOCATION 



This section is intended to answer the question — where does MCS BASIC-52 store its variables and 
strings? 

Two 16 bit pointers stored in external memory control the allocation of strings and variables and an 
additional two pointers control tiie allocation of scalar vadabl^ and (Umensioned variables. These poii^eii 
are located and defii^ as foUov^: 



LOCATION (H-L) NAME DESCRIPTION 



10AH-10BH MTOP THE TOP OF RAM THATIS ASSIGNED TO BASIC 

104H-105H VARTOP VARTOP = MTOP - (THE NUMBER OF BYTES OF MEM- 

ORY THAT THE USER HAS ALLOCATED FOR STRINGS). 
IF STRINGS ARE NOT USED, VARTOP = MTOP 

106H-107H VARUSE AFTER A NEW, CLEAR, OR RUN IS EXECUTED, VARUSE = 

VARTOP, EVERYTWiE THE USER ASSIGNS OR USES A 
VARIABLE VARUSE m DECREMENTED BY A COUNT OF 8. 

108H-109H DIMUSE AFTER A NEW, CLEAR, OR RUN IS EXECUTED, DIMUSE = 

[LENGTH OF THE USER PROGRAM THAT IS IN RAM MEM- 
ORY + STARTING ADDRESS OF THE USER PROGRAM IN 
RAM (512) 4- THE LENGTH OF ONE FLOATING POINT 
NUMBER (6)]. IF NO PROGRAM IS IN RAM MEMORY, 
DIMUSE = 518 AFTER A CLEAR IS EXECUTED 



MCS BASIC-52 stores string variables between VARTOP and MTOP. $(0) is stored from VARTOP to 
VARTOP + (user defined string length + 1), $(1) is stored from VARTOP + (user defined string length 
'4- 1) + 1 to VARTOP + 2* (user defined string length + 1) etc. If MCS BASIC-52 attempts to access 
a stiiog thitf is outside die b^di-eitaMidied by MTOP , a MEMORY ALLOCATION ERROR is generated. 

Now, Scalar variables are stored from VARTOP "down" and Dimensioned variables are stored from 
DIMUSE "up." When the user dimensions a variable either implicity or explicity the value of DIMUSE 
increases by the number of bytes required to store that dimensioned variable. For example, if the user ex- 
ecutes a DIM A(10) statement, DIMUSE would increase by 66. This is because the user is requesting 
^in^e for 11 maibeiis (A(0) din»]gb A(10)) and each number isquiies 6 bytes for borage and 6*11 =66. 
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1.7 STORAGE ALLOCATION 

As mentioned in the previous example, everytime the user defines a new variable the VARUSE pointer 
decrements by a count of 8. Six of the eight counts are due to the memory required to store a floating 
point number and the other two counts are the storage required for the variable name (i.e. Al, B7, etc). 
The variable B7 would be stored as follows: 

DESCRIPTION -u 

THE ASCII VALUE — 7, IF B7 WAS A DIMENSIONED VARIABLE THE 
MOST SIGNIFICANT BIT OF THIS LOCATION WOULD BE SET. IN 
VERSION 1.1 THIS LOCATION ALWAYS CONTAINS THE ASCII 
VALUE FOR THE LAST CHARACTER USED TO DEFINE A 
VARIABLE 

THE ASCII VALUE — B, IN VERSION 1.1 OF MCS BASIC-52 THIS 
LOCATION CONTAINS THE ASCII VALUE OF THE FIRST CHARAC- 
TER USED TO DEFINE A VARIABLE PLUS 26 * THE NUMBER OF 
CHARACTERS l^ED TO DERNE A VARIABLE, IF THE VARIABLE 
GONmiNS MORE IHm 2 CHARACTERS. 

THE NEXT SIX LOCATIONS WOULD CONTAIN THE FLOATING 
POINT NUMBER THAT THE VARIABLE IS ASSIGNED TO, IF THE 
VARIABLE WAS A SCALAR VARIABLE. IF THE VARIABLE WAS DI- 
MENSIONED, X-2 WOULD CONTAIN THE LIMIT OF THE DIMENSION 
(I.E. THE MAX. NUMBER OF ELEMENTS IN THE ARRAY) AND 
X-3: X-4 WOULD CONTAIN THE BASE ADDRESS OF THE ARRAY. 
THIS ADDRESS IS EQUAL TO THE OLD VALUE OF THE DIMUSE 
POINTER BEFORE THE ARRAY WAS CREATED 

Whenever a new scalar or dimensioned variable is used in a program, MCS BASIC-S2 checks both the 
DftiUSE nd VARUSE pointers to make sure that VARUSE > jDOiUSE. M &e relatioBShqi.is not tim^ M 
MEMORY ALLOCATION ERROR is generated. 



LOCATION VALUE 

X 37H 



X-1 42H 



X*2 ?? 
THRU 
X-7 
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To Summarize: 

Strings are stored from VARTOP to MTOP. 

Scalar variables are stored from VARTOP "down" and VARUSE points to tiie next available scalar kicsdw. 

Dimensioned variables are stored from the end of the user program in RAM "up." If no program is in 
IM(i this location is 5 1 8 . DINfUSE isseps track of the number of bytes tiie iis(^ has located for dim^sionsd 
vadables. 

BEMUSE > = VARUSE a NffiMORY ALLOCATION ERROR is genraated 



.?itiT ; 

,•1* '-^f hft* f 
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1.8 FORMAT OF AN MCS BASIC-52 PROGRAM 

This section answers the question "How does MCS BASIC-52 store a program?" 
UNE FORMAT 



Each line of MCS BASIC-52 text consists of tokens and ASCII characters, plus 4 bytes of overhead. Three 
of these four bytes are stored at the beginning of every line. The first byte contains the length of a line in 
binary and the second two bytes are the line number in binary. The fourth byte is stored at the end of the 
Une aod this byte is always a ODH m a carriage return in ASQI. An exmapie of a typical line is shown 
below, asHirae tiiat Ms is die fiM of a program in RAM. 

10 FOR I = 1 TO 10 : PRINT I : NEXT I 

LOCATION BYTE DESCRIPTION 

512 11 H THE LENGTH OF THE LINE IN BINARY (17D BYTES) 

513 OGH HIGH BYTE OF THE LINE NUMBER 

514 GAM LOW BYTE OF THE LINE NUMBER 

515 OAGH THE TOKEN FOR "FOR" 

516 49H THE ASCII CHARACTER "I" 

517 OEAH THE TOKEN FOR" = " 

518 31H THE ASCII FOR "1" 

519 GA6H THE TOKEN FOR "TO" 

520 31 H THE ASCII FOR "1" 

521 30H THE ASCII FOR "0" 

522 3AH THE ASCII FOR ":" 

523 89H THE TOKEN FOR "PRINT' 

524 49H THE ASCII FOR "I" 

525 3AH THE ASCII FOR ":" 

526 97H THE TOKEN FOR "NEXT' 

527 49H THE ASCII FOR "I" 

528 ODH END OF LINE (CARRIAGE RETURN) 

TO FIND THE LOCATION OF THE NEXT LINE, THE LENGTH OF THE UNE IS ADDED TO THE 
LOCATION WHERE THE LENGTH OF THE LINE IS STORED. IN THIS EXAMPLE, 
512 + 17D = 529, WHICH IS WHERE THE NEXT LINE IS STORED. 

The END of a program is designated by the value OIH. So, in the previous example if line 10 was the 

only line in the program, location 529 would contain the value OIH. A program simply consists of a numba 
of Unes packed together in one continuous block with the last line ending in a ODH, OIH sequence. 
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EPROM FILE FORMAT 

The EPROM FILE format consists of the same line and program format, previously described except that 
each program in the EPROM file begins with the value 55H. The value 55H is only used by MCS BASIC- 
52 to determine if a valid prognini is present. If the user types ROM 6, MCS BASIC-S2 acmHf'^^ 
through the first program stored in EPROM line by line until the END of PROGRAM (OIH) is found, 
then it examines the next location to see if a 55H is stored in that location. It then goes through that 
program line by line. This process is repeated 6 times. If the character SSH is not found afterte miW 
a program, MCS BASIC-S2 will return with the PROM MCSMemx message. This would mean that Ie$s 
dian six programs were stored in that EPROM. 

The first program st(»:ed in EPROM (ROM 1) always begins at location 8010H and fliis locaiKHl will idv^pi 
contain a 55H. The actual user program will begin at location 801 IH. 

EPROM locations 8000H through 800FH are reserved by MCS BASIC-52. These locations contain ini- 
tialization information when the PROGX options are used. Version 1.0 of MCS BASlC-52 only used the 
first diree bytes of this reserved EPROM aiea. The infcmiiation stored in these bytes is as follows: 

LOCATION DESCRIPTTON 

8000H CONTAINED A 31 H IF PROG 1 WAS USED, CONTAINED A 32H IF PROG 2 
WAS USED 

8001 H BAUD RATE (RCAP2H) 

8002H BAUD RATE (RCAP2L) 

Version 1.1 of MCS BASIC-S2 uses the same locations as V^ion 1.0, but additionally locations 8003H 
and 8004H (high byte, low byte) are used to store the MTOP information for the PROG 3, 4, 5, 6 oftdons. 

IMPORTANT NOTE — / 

The PROG X options simply store ASCII character following the PROG command in loction 8000H. That 
is why PROG 1 stores a 31H in location 8000H, PROG 2 a 32H, PROG 3 (Version 1.1 only) a 33H ete. 
If the user employs the user defined reset option defined in Chapter 1 1 of this manual, it would be possible 
for the user to create unique PROG options. For example, PROG A would store a 41H in location 8000H 
mi upon RESET the user could examine this location with an assembly language routine wd gsBm$& a 
unique PROG A re^ routine fm tiast particular application. 

- J^o 
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1.9 ANSWERS TO A FEW QUESTIONS 

QUESTION 

Why can't MCS BASIC-52 access flje 8052's SPECIAL FUNCTION REGISTHl SCON? 
ANSWER 

The only time the user would likely change the contents of SCON is if the user is writing custom I/O 
drivers in assembly language. If the us^ is writing assembly langui^e I/O driv^, then the user can change 
the contents of SCON in assembly lanpiage. Qite^mg the contents of SCON can cause MCS BASIC- 
52's console routines to crash. 



I have written an upload/download routine using my computer, but when I download a program, MCS 
BASIC-S2 misses diaracters, why? 



MCS BASIC-52 is actually capable of accepting characters at 38,400 baud. The problem is that after MCS 
BASIC-52 receives a carriage return (or), it tokenizes the line of text that was just entered. Depending on 
how complicated and how long the hne is, MCS BASIC-52 can take up to a couple of hundred miUiseconds 
to tokenize the line. If the user keeps stuffing characters into the serial port while MCS BASIC-52 is 
tokenizing the line, the characters will be lost. What the user must do in the download routine is wait until 
MCS BASIC-52 responds with the prompt character (>) after a carriage return is sent to the MCS BASIC- 
52 device. The prompt (>) informs the user that MCS BASIC-52 is ready to receive characters from the 
console device. 



I am writing in assembly language and I notice that the 8052AH has no decrement DPTR instruction. What 
is the easiest, shortest or simplest way to decrement the DPTR? 

ANSWER 

The shortest one v/e know is: 



QUESTION 



ANSWER 



QUESTION 



DECDP: 



XCH 
JNZ 
DEC 
DEC 
XCH 



A 

A, DPL 



A, DPL 

DECDP 
DPH 



SWAP AoDPL 

DPH * DPH- 1 IF DPL = 



DPL = DPL-1 



Tliis routine affects no 



flags fx Kg^mm (excqit the DPIH) eitha! 



m 
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1.9 ANSWERS TO A FEW QUESTIONS 
QUESTION ■ i ' 

After RESET or pow^-up, BASIC-52 does not return the fsj^r value fot MTOP, what's 4^ 
problem? 

ANSWER 

Virtually everytime this problem occurs it is because something is wrong with the decoding circuitry in 
system or one or more of the address lines to the RAM are open or shorted. The user should make 
sure that all of the address .^les to the system RAM are coonectecl ppg|ie%{'' 

A simple memory test can be implemented in the COMMAND MODE to verify the addressing to the 
RAM. First set XBY(IOOOH) = 55, then walk ones across the address (i.e. P. XBY(IOOIH) - P. 
XBY(1002H) - P. XBY(1004H) - P. XBY(1008H) P. XBY(IOIOH)) until all locations are tested. If 
for instance, P. XBY(1008H) returns a result of 55, ^n address line 3 (A3) would probably be open ox 
shorted. 
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1.10 PIN-OUT LIST 

The following is a pin-out list of the most conunon devices found in an MCS BASIC-52 system: 







u] Vcc 


impota[T 






13] INPUT D1 


oifrpuTA[T 
■miTBi [T 




12] MPUriH 
n] OUTPUTD 


OUTPUT B [T 






To] HPUTC1 

T] INPUT C2 


QMD [T 




T] OUTPUT C 



01E 

o»|T 

03 IS 



INPUT A [T 

RESPONSE r— 
CONTnOLA Li- 

0WrPUTA[7 
WPUTB [T ■ 

CONTROL e 

OUTPUT B [T -C ^ [ — 

GROurtt) [T 



lt5 



]«] Vcc 
INPUT O 

— ^ COHinOLD 
TT] OUTPUTD 

"tol MWTC 

1 RESPONSE 
^ CONTROL C 
■ T] OUTPUT C 



in 07 
[3 07 

ISO, 
ii>4 



}0 









[T«o 

[T«, 

E«. 

EB7 

S OK) 



Vcc 50 
II>n| 



74LSt3S 




[1 

E 
E 






E 

E 
E 






qnd(7 







ulvcc 

ID 

in 
ni 

II 

3 ■ 



74LS08 
74LSO0 

mvenriNG 




27256 


Z784A 


273U 


vpp 


VPP 




«12 


A12 




«7 


»7 


A7 


«« 


•e 


Ae 


»5 


»5 


As 


»4 


«4 


A4 


»3 


A3 


A3 


»2 


A2 


A2 


»1 


Al 


Al 


«0 


AO 


AO 


Oo 


Oo 


Oo 


01 


Ol 


Ol 


02 


Oj 


oa 


OND 


GND 


OHO 




2732A 


2764A 


27250 




Vcc 


Vcc 




fSu 


Al4 


»CC 


N.C. 


A13 


As 


Ao 


Ao 


AO 


A« 


Ao 


All 


A11 


A11 


OE>Vpp 


5e 


OE 


A10 


AlO* 


A10 


CE 


Cl 


SE 


07 


O7 


07 


Oo 


Oo 


Oo 


OS 


OS 


O5 


04 


04 


04 


OS 


o> 


Os 







n/PM|T 




i«ce 


PA3[T 




^ PA4 












PA2[r 




i|PA5 






pwMovmir/piJll] 




gjun 


mil 




^PW 












p«o|T 




^P«7 






naAiuiinitse/pij[£ 




gM» 


hbE 




gWH 


NC [T 




?§ivcc 


MMMIUIieiUIU(PU[|] 




g«l>4 






Preset 








^ADS 


GND [F 




go. 


A12](T 




27] WB 


UNE PUMTBI OUTPUT / P1.7 [T 




^ADO 


A,[T 




i3\ 


A7,|T 




»]:NC 


RESET [? 




^A07 


AOE 




j§D2 


"•IE 






CONSOLE SERIAL INPUT [10 


8a52AH- 


n] -t-SVOLIS 


PC7 g| 


8255A 




••IE 




01 Ao 


CONSOLE SERIAL OUTPUT^ 


BASIC 


^ALE 


pce^ 




^04 


AolE 




1A„ 


■RBlBniBBDBrg 




iWR 


pcsEs 






A3 Id 




isi 






3*« 


PC4 55 




ios 






fi)A,o 


TO [14 




Qma 


pco|^ 




53 D7 






»]CE 


T1 51 




g*n 


PCI gi 




^Vcc 






|11'07 


WH[i6 




^A12 


PCI 01 




^PB7 






gK>o 


HD[17 




I^ah 


PCS^ 




^PBS 


1(0, |g2 




13 "OS 


KTAU^ 




gAlO 


paogi 




gPBS 






3w>s 






i» 


PS1 S 




^PB4 






!iw>s 


vng 






POtg 




Rjpss 



7406/LSa4/LS0S 
7407 NON- 
INVERTING 
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1.11 maAHSPmi^FUNCTtONfieet^iiis 

The following details the operation of the special function registers on the 8052AH: 



SYMBOL 
NAME 


mm 


ADDRESS 


MCS BASIC-S2 


ACC 


Accumuldtor 


OEOH 


NOT ADDRESSABLE 


B 


B RoQister 


OFiDH 


NOT ADDRESSABLE 


PSW 


Program Status Word 


OOOH 


NOT ADDRESSABLE 


SP 


Stack Pointer 


81 H 


NOT ADDRESSABLE 


DPTR 
DPH 
DPL 


Data Pointar 2 Bvtes* 
Low Byte 
High Byte 


82H 
83H 


NOT ADDRESSABLE 
NOT ADDRESSABLE 


PO 


Port 


80H 


NOT ADDRESSABLE 


PI 


Port1 


90H 


PORT1 


P2 


Port 2 


OAOH 


NOT ADDRESSABLE 


P3 


Port 3 


mm 


NOT ADDRESSABLE 


IP 


interrupt Priortty Control 


0B8H 


IP 


IE 


Interoipt Enalito^onlK)! 


0A8H 


IE 


tMOD 


Timer/Countsr MMe Control 




TMOD 


ICON 


Timer/Counter Control 


em 


T£X)N 


T2CON 


Timer/Counter 2 Con^ol f . 


0C8H 


T2C0N 


THO 


Tlmer/CounMr 6 Byte 


8CH 


} TIMERO 


TLO 


Timer/Counter Low Byte 


8AH 




THI 


Timsr/Counter 1 Hiah Bvte 

1 IlllOlf VUl 1 iOI 1 1 null Lrf V 


SDH 


\ TIMFR1 


TL1 


Timftr/f^ni intpr 1 1 nw Rvtp 
1 1111^1/ Vi^uu 1 1171 1 TV i—'y i V 


8BH 




i rf4£ 


1 imer/oounier ^ niyn Dyie 




} TIMER2 


TL2 


Timer/Counter 2 Low Byte 


OCCH 




RCAP2H 


T/C 2 Capture Reg. High Byte 


OCBH 


}RCAP2 


RCAP2L 


T/C 2 CaptuRC Low Byte 


OCAH 




SCON 


Serial Control 


98H 


NOT ADDRESSA^ 


SBUF 


Serial Data Buffer 


99H 


NOT ADDRESSABLE 


PCX)N 


Power Control 


87H 


NOT ADDRESSABLE 



IP 
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1.11 8052AH SPECIAL FUNCTION REGISTERS 
PSW: PROGRAM STATUS WORD. ADDRESS ODOH 



CY 


AC 


FO 


RSI 


RSO 


T 

OV 




P 



CY 


PSW.7 


Carry Rag. 


AC 


PSW. 6 


Auxiliary Carry Flag. 


FO 


PSW.5 


Flag available to the user for general purpose 


RS1 


PSW.4 


Register Bank selector bit 1 . 


RSO 


PSW. 3 


Register Bank selector bit 0. 


OV 


PSW.2 


Overflow Hag. 




PSW.l 


RESERVED FOR FUTURE USE. 


P 


PSW.O 


PARITY FLAG. 



PCON: POWER CONTROL REGISTER. NOT BIT ADDRESSABLE. 



SMOD 

















SMOD Doubles die baud rate when TIMER 1 is used to generate the baud rate for the serial port. 
The remaining bits of PCON we not implemented on the MCS BASIC-52 device. 



inter 



MC8» mmmm 



'rf 



1 .1 1 8052AH SPECIAL FUNCTION REGISTERS 



GATE 



C/T 



(MSB) 



(LSB) 



GATE 















C/T 


M1 


MO 


GATE 


C/T 


M1 



MO 



Gating control When set. Tim er/Counter "x" 
is enabled only while "INTx" pin is high and 
'TRx" control pin Is set. When cleared Timer 
"X" is enabled wMtMl^ 'TFbf eemttol 1^^ 
set 

Timer or Counter Selector Cleared tor Timer 
operation (input from internal system clock). 
Set for Counter operation (input from ' Tx" 
input pin). 



— V — 

TIMER — - 

M1 MO Operating Mode 
MCS-48 Timer "TLx" serves as five-bit 
prescaler. 

1 16 bit Timer/Counter "THx" and "TLX" 

are cascaded; there is no prescaler 

1 8-bit auto-reload timer-counter "THx" 

holds a value which Is to be reloadisd into 
'TLx" each time it overflows. 



(Timer 0) TLO is an eight-bit timer 
counter-controlled by the 
standard Timer control bits 
THO is an eight-bit timer only 
controlled by Timer 1 control 
bits. 

(Tftner 1) Timer-counter 1 stopped. 



TMOD: Timer/Counter Mode Control Register 



1 .1 1 8052AH SPECIAL FUNCTION REGISTERS 



(MSB) 



(LSB) 



TF2 


EXF2 


RCLK 


TCLK 


EXEN2 


TR2 


c/fi 





Name wnt fl^teanee 



TF2 T2CON.7 

m(F2 T2CON.6 

RCLK T2CON.5 

TCLK T2C0N.4 

E}ffiN2 T2CON.3 

■mz T2C0NJ 

C/1S T2CON.1 

CP/RQ T2CON.0 



Timer 2 overflow flag set by a Timer 2 overflow and must be deaped l;y scMware. TF2 
will not be set when either RCLK = 1 or TCLK = 1 . 

Timer 2 external flag set when eHher a c^)ture or rekjad Is caused by a negative 
transition on T2EX and EXEN2 = 1. When Timer 2 interrupt is enabled, EXF2 = 1 
will cause the CPU to vector to the Timer 2 interrupt routine. EXF2 must lie cleared by 

software. 

Receive clock flag. When set, causes the serial port to use Timer 2 overflow pulses 
for its receive clock In modes 1 and 3. RCLK ^ catses Timer 1 overflow to be used 

for the receive clock. 

Transmit clock flag. When set, causes the serial port to use Timer 2 overflow pulses 
for its transmit dock in modes 1 and 3. TCLK = causra Timer 1 overflows to be 
used for the transmit dodc 

Timer 2 external enable flag. When set, allows a capture or reload to occur as a result 
of a negative transition on T2EX If Timer 2 Is not being used to clock the serial port. 
EXEN9 »,#QipiseSjTimer 2 to ignore events at T2EX. 

Start/stop control for Timer 2. A logic 1 starts the timer. 

Timer or counter select. (Timer 2) 

= Internal timer (OSC/1 2) 

1 = External event counter (falling edge triggered). 

Capture/Reload flag. When set, captures will occur on negative transitions at T2EX if 
EXEN2 = 1 . When cleared, auto reloads will occur either with Timer 2 overflows or 
negative transitions at T2EX when EXEN 2 = 1. When either RCLK = 1 or TCLK = 1, 
this bit is tgnared and the timer is forced fo auto-reioad on Timer 2 overflow. 



HMer/Countor 2 Control Register 



iny 
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1.11 8052AH SPECIAL FUNCTION REGISTERS 



(MSB) (LSB) 


SMO 


SMI 


SM2 


REN 


TBS 


RB8 


Tl 


Rl 



Where SMDj SMI sjpecify the serial {kmI mode, as follows: 



SMO ^1 Mode 



3 



Dracription Baud 
Rate 

shift fosc./12 
register variable 

8- bit UART fosc./64 

9- bit UART or 

fosc732 
9-bit UART variable 



• SM2 



• REN 



enables the multiprocessor communication 
feature in modes 2 and 3. In mode 2 or 3, 
If SM2 is set to 1 then Rl will not be activated 
if the received 9th data bit (RB8) is 0. In 
mode 1, if SM2 = 1 then Rl will not be 
activated if a valid stop bit was not received. 
In mode 0, SM2 should be 0. 

cables serial reception. Set by software to 
enable reception. Clear by software to dis- 
able reception. 



• TB8 is the 9th data bit that will be transmitted in 

modes 2 and 3. Set or clear by software as 
desired. 

• RB8 In modes 2 and 3, is the 9th data bit that 

was received. In mode 1, if SM2 = 0, RB8 
is the stop bit that was received. InnradeO, 
RB6 not used. 

• Tl is transmit interrupt flag. Set by hardware at 

the end of the 8th bit time in mode 0, or at 
the beginning of the stop bit in the other 
modes, in any serial transmission. Must be 
cleared by software. 

• Ri Is receive Intermpt flag. Set by harcAware at 

the end of the 8th bit time in mode 0, or 
halfway through the stop bit time in the otttr 
modes, in any serial reception (except see 
SM2). Must be cleared by software. 



SCON: Serial Port Control Register 



(MSB) (LSB) 


TF1 


TR1 


TFO 


TRO 


IE1 


IT1 


lEO 


ITO 



Symbol Position Name and Significance 



Symbol Position Name and Significance 



TF1 fCON.7 Timer 1 overflow Flag. Set by lEI TC0N.3 
hardware on timer/counter ov- 
erflow. Cleared by hardware 
when processor vectors to inter- 
mptrotiUne. HI T&M^ 

TR1 TCON.6 Timer 1 Run control bit. Set/ 
cleared by software to turn timer/ 
counter on off. 

TFO TCON.5 Timer overflow Flag. Set by lEO TC0N.1 
hardware on timer/counter ov- 
erflow. Cleared by hardware 
when processor vrators to Inter- 
rupt routine. ITO TCON.O 

TRO TCON.4 Timer Run control bit. Set/ 
cleared by software to turn timer/ 
counter on/off. 



Interrupt 1 Edge flag. Set by 
hardware when external inter- 
rupt edge detected. Cleared 
when Interrupt processed. 
Interrupt 1 Type control bit. Set/ 
cleared by software to specify 
failing edge/low level triggered 
external interrupts. 
Interrupt Edge flag. Set by 
hardware when external inter- 
rupt edge detected. Cleared 
when interrupt processed. 
Interrupt Type control bit. Set/ 
cleared by software to specify 
falling edge/low level triggered 
external intentipts. 



ICON: Timer/Counter Control Register 



W7 



HiteT 



1 .1 1 8052AH SPECIAL FUNCTION REGISTERS 



(MSB) LSB) 


X 


X 


PT2 


PS 


PT1 


PX1 


PTO 


PXO 



Symbol Position Function 

— IP.7 reserved 

— iP.6 rraerved 

PT2 IP.5 defines the Timer 2 interrupt 
priority level. PT2 = 1 programs 
K to the higher priocity level. 

PS IR4 defines the Serial Port interrupt 
priority level. PS = 1 programs 
It to the higher prioilty level. 

PTI IP.3 defines the Timer 1 interrupt 
priority level. PTI = 1 programs 
it to the higher priority level. 

PX1 IP.2 defines the External Interrupt 1 
priority level. PX1 = 1 programs 
it to the higher priority level. 

PTO IP.1 defines the Timer interrupt 
priority level. PTO = 1 programs 
it to the higher priority level. 

PXO iP.O defines the External Interrupt 
priority level. PXO = 1 programs 
It to the higher priority level. 



IP: interrupt Priority Register 



(MSB) 



LSB 



EA 



ET2 



ES 



ET1 



EX1 



ETC 



EXO 



Symbol Position Function 

EA iE.7 disables all intermpts. if EA = 0, 
no interrupt will be acknowl- 
edged. If EA = 1 , each interrupt 
source is individually enabled or 
disabled by setting or deatlng its 
enable bit. 

— IE.6 reserved 

ET2 IE.5 enables or disables the Timer 2 
overflow or capture interrupt, if 
ETZ = 0, the Timer 2 interrupt 
is disabled. 

ES IBA enables or disables the Serial 

Port interrupt. If ES = 0, the Se- 
rial Port interrupt Is disabled. 

ET1 IE.3 enables or disables the Timer 1 
Overflow interrupt. If ET1 = 0, 
the Timer 1 interrupt is disabled. 

EX1 iE.2 enables or disables External In- 
terrupt 1. If EX1 =0, External 
Interrupt 1 is disabled. 

ETO IE.1 enables or disables the Timer 
Overflow interrupt. If ETO = 0, 
the Timer Interrupt is disabled. 

EXO iE.O enables or disables External In- 
tenxipt 0. If EXO = 0, External 
Interrupt Is disabled. 



IE: Interrupt Enable Register 
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APPENDIX B 

» 



INSTRUCTION SET SUMMARY 

This appendix contains two tables (see tables B-1 and B-2): the first identifies all of the 8052 's instructions 
in alphabetical order; the second table lists the instructions according to their hexadecimal opcodes and 
lists the assembly language instnietiens that prodQced that opcode. 

The alphabetical listing also includes documentation of the bit pattern, flags affected, number of machine 
cycles per execution and a description of the instructions operation and function. The list below defines 
the conventicHis used to idaitify apexsl&m: and bit psotsiis. 



ABBREVIATIONS AND NOTATIONS USED 



A 


Accumulator 


illlllll 


One byte of a 1 6-bit 


AB 


Register Pair 




address encoded in 


B 


Multiplication Register 




operand byte 


bit address 


8052 bit address 


mmmmmmmm 


Data address encoded in 


page address 


1 1-bit code addtms witttin 




operand byte 


2K page 


oooooooo 


Relative offset encoded in 


relative offset 


8-bit 2's complement offset 




operand byte 


C 


Carry Flag 


rotrrr 


Register identifier encoded 


code address 


Absolute code address 




in operand byte 


data 


Immediate data 


AND 


Logical AND 


data address 


On-chip 8-bit BAM address 


NOT 


Logical complement 


DPTR 


Data pointer 


OR 


Logical OR 


PC 


Program Counter 


XOR 


Logical exclusive OR 


Rr 


Register (r = 0-7) 


-t- 


Plus 


SP 


Stack pointer 




Minus 


higti 


High order byte 


/ 


Divide 


low 


Low order byte 


• 


Multiply 


H 


Bits i through j 


(X) 


The contents of X 


.n 


Bit n 


((X)) 


The memory location 


aaa s^aaaaa 


Absolute page address 
encoded in instruction 




addressed by (X) 
(The contents of X) 




and operand byte 




Is equal to 


bbbbbbbb 


Bit address encoded in 


< > 


Is not equal to 




operand byte 


< 


Is less than 


dddddddd 


Immediate data encoded in 


> 


Is greater than 




operand byli 




Is replaced by 
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Table B-t. hnstru^ion Set Summary 



Mnemonic 
Operation 


Cycies 


Binary 
Code 


Flags 
P OV AC C 


Function 


ACALL code addr 
(PC) «- (PC) + 2 
(SP) «- (SP) + 1 
((SP)) «- (PC) low 
(SP) ^ (SP) + 1 
((SP)) ^ (PC) high 
(PC) 0-10 <- pagre address 


2 


aaalOOOl 
aaaaaaaa 




Push PC on stack, and 

replace low order 1 1 bits 
with low order 1 1 bits of 
code address. 


ADD A,#data 

(A) «- (A) + data 


1 


10 10 
dddddddd 


P OV AC C 


Add immediate data to A. 


ADD A,(5)Rr 

(A) ^ (A) + ((Rr)) 


1 


1 1 1 r 


POVACC 


Add contents et «idjract 
address to A. 


ADD A,Rr 

(A) ^ (A) + (Rr) 


1 


1 1 r r r 


POVACC 


Add register to A. 


■ « . 

ADD A,data addr 

(A) «- (A) + (data address) 


1 


00100101 
mmmmmmmm 


P OV AC C 


Add contents of data 
address to A. 


ADDC A,#data 

(A) <- (A) + (C) + data 


1 


110 10 
dddddddd 


P OV AC C 


Add C and inKfiBcytte dala 

to A. 


ADDC A,@Rr 

(A) ^ (A) + (C) + {(Rr)) 


1 


00 1 1 1 1 r 


P OV AC C 


Add C and contents of 

indirect address to A. 


ADDC A,Rr 

(A) - (A) + (C) + (Rr) 


1 


1 1 1 r r r 


P OV AC C 


Add C and register to A. 


ADDC A.dafa addr 

(A) <- (A) + (C) + (dafa address) 


1 


1 10 10 1 
mmmmmmmnn 


P OV AC C 


Add C and contents of data 

address to A. 


AJMP code addr ( 
(PC) 0-10 *- code addmf^ 

i : " --■ • 


2 


a a a 1 
aaaaaaaa 




Replace low order 11 tills (it 
PC with low order 11 bits 
code address. 


\ ANL A,#d«a 

(A) <- (A) AND date 


1 


10 10100 

dddddddd 


P 


Logical AND lmme(fiate data 
to A. 


ANL A,@Rr 

(A) ^ (A) AND ((Rr)) 


1 


1 1 1 1 r 


P 


Logical AND contents of 
indirect address to A. 


ANLA.Rr 

(A) «- (A) AND (Rr) ' . 


1 


1 1 1 r r r 


P 


Logical AND regpter to A. 


ANL A,date addr 

(A) ^ (A) AND (data address) 


1 


10 10 10 1 

mmmmmmmm 


P 


" 

Logical AND contents of 

data address to A. 


ANL CM addr 

(C) <- (C) AND (ftff address) 


2 


100000 10 
bbbbbbbb 


c 


Logical AND bit to C. 


ANL C.lbit addr 

(C) *- (C) AND NOT {bit address) 


2 


1 1 1 
bbbbbbbb 


c 


Logical AND (liMplemerU of 

bit to C. 


ANL data addr, #data 

{data address) «- 

{data address) AND data 


2 


10 10 11 

mmmmmmmm 
dddddddd 




Logical AND immediate data 
to contents of data address 


"ANL data addr.A 

(data address) <- 

(data address) AND A 


1 


10 10010 
mmmmminmm 




Logical AND A to contents of 
dtOa address. 



mi 
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Table B-1. Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


CJNE @Rr,#date^cocte atklr 
(PC) *- (PC) + 3 
IF ((Rr)) < > data 
THEN 

(PC) ^ (PC) + relative offset 
IF {(Rr)) <data 
THEN (C) «- 1 
ELSE (C) «- 


2 


1 1 1 1 1 r 
dddddddd 
oooooooo 


C 


If immediate data and 
contents of Indirect address 
are not equal, jump to code 
address. 


CJNE A,#data,code addr 
(PC) ^ (PC) + 3 
IF (A) < > data 
THEN 

(PC) <- (PC) + relative offset 
IF (A) <data 

THEN (C) ^ 1 
ELSE (C) ^ 


2 


10110 100 

dddddddd 
oooooooo 


C 


If Immediate data and A are 
not equal, jump to code 
address. 


CJNE A,data addr.code addr 
(PC) ^ (PC) + 3 
IF (A) < > (data address) 
THEN 

(PC) «- (PC) + relative offset 
IF (A) < (data address) 
THEN (C) «- 1 


2 


10 110 10 1 
minmmnitDnim 
oooooooo 


C 


If contents of data address 
and A are not equal, jump to 
ood<a address. 


CJNE Rr,#data,code addt 

IF (Rr) < > data 
THEN 

(PC) «- (PC) + relative offset 
IF (Rr) < dafa 

THFN ir,\ «— 1 

ELSE (C) ^ 


2 


1 1 1 1 r r r 
oooooooo 


c 


If immediate data and 

rAniQtor stro rtni Ani lal ii imn 

■ opioid Clio 1 lUl 0\.(UCII, JUlII|i 

to code address. 


PI R A 

(A)-^O 




1 1 100100 


p 


5%At A in 7Arn t(W 


CLRC 


1 


110000 11 


c 


Set C to zero (0). 


PI R hit aHrir 

(bit address) *- 




1 \ \j Kj \j yj \ \j 

bbbbbbbb 




Qnt hit tn 7am ^0^ 


(A) *- NOT (A) 




11110100 

1 1 1 IvIwVf 


p 


f^mrmlAmAntc osf^ hit in A 


ppi p 

(C) ^ NOT (C) 




iniinnii 






CPL bit addr 

(bit address) <- 

NOT (bit address) 




10 110 10 

bbbbbbbb 




CoiTiDlemfint bit 


DA A 




110 10 10 


P c 


Adjust A after a BCD add. 


DEC @Rr 

((Rr)) ^ ((Rr)) - 1 




1 1 1 r 




Decrement contents of 
indirect address. 


DEC A 

(A) ^ (A) - 1 




00010100 


p 


Decrement A. 


DECRr 

(Rr)<-(Rr) - 1 




1 1 r r r 




Decrement register. 




MCS® BASIC-52 



Table B-1. Instruction Set Summary (Cont'd.) 



1 Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


DEC data addr 

{data address) «— 

(data address) - 1 


1 


0001 0101 
iTiiTinifninnininfi 




Decrement contents of data 
address. 


DIVAB 

(AB) ^ (A)/(B) 


4 


1 00001 00 


P OV c 


Divide A by B (multiplication 
register). 


DJNZ Rr,code addr 
(PC) <- (PC) + 2 

' IF (Rf) < > 
THEN 

(PC) *- (PC) + relative offset 


2 


1 1 1 1 r r r 

00000000 




Decrement register, If 

zero (0), tfien jump to o^de i 

address. 

1 


DJNZ data addr.code addr 
(PC), «- (PC) + 3 
{data address) *- 
{data address) — 1 
f IF {data address) <> 
>,THEN 

' (PC) *- (PC) + relative offset 


2 


110 10 10 1 
mmmmmmmm 

00000000 




Decrement data address, if 
zero (0), then jump to code 
address. 

! 


1 INO @ Rr 

' ((Rr))^((Rf)) + 1 


1 


1 1 r 




Increment contents of . 
indirect address. ; ' 


' INC A 

(A) - (A) + 1 


1 


10 


P 


Increment A. 


INC DPTR 

(DPTR) (DPTR) + 1 


1 


10 100011 




Increment 16^ data 
pointer. 


INC Rr 

((R) ^ (Rr) + 1 


1 


1 r r r 




increment register. 


INC data addr 
' (daJa address) «- 

(data address) + 1 


2 


00000 10 1 
mrtimmmmnim 




IncremeiTt contents of data 
address. 


JB bit addr.code addr 

(PC) ^ (PC) + 3 

IF (bit address) = 1 
' THEN 

(PC) *- (PC) + re/afi'we offset 


2 


1 
bbbbbbbb 

00000000 




If bit is one, n jump to code 
address. ^7'1 


JBC bit addr,code addr 
(PC) ^ (PC) + 3 
IF (bit address) = 1 
I -THEN 

{bit addfBSs) «~ 

(PC) «- (PC) + relaOve a«se* 


2 


0001 0000 
bbbbbbbb 

00000000 




If bit is one n clear bit and 
jump to code address.' ' " ' 


JC code addr * \ 

(PC) <- (PC) + 2 _. 

IF (C) = 1 
THEN 

(PC) <- (PC) + relative oHset 


2 


01 000000 

00000000 




If C is one, then jump to 
code address. 

..>>« 


JMP @ A + DPTR 

(PC) ^ (A) + (DPTR) 


2 


1110011 




Add A to data pointer and 
jump to that code address. 


JNB bit addr,code addr 
(PC) ^ (PC) + 3 
IF (bit address) = 
THEN 

(PC) «- (PC) + relative offset 


2 


1 1 
bbbbbbbb 

00000000 




If bit is zero, n jump to code 
address. 
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Table B-1. Instruction Set Summary (Cont'd.) 



Mnemonic 

winsriHivii 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


JNC code addr 

(PC) + (PC) + 2 
IF (C) = 
THEN 

(PC) <— (PC\ + relative offset 


2 


0101 0000 
oooooooo 




If C is zero (0), n jump to 
code address. 


JNZ code addr 

(PC) <- (PC) + 2 
IF (A) <> 
THEN 

(PC) «- (PC) + r^adve offset 


2 


1110000 
oooooooo 




If A is not zero (0), n jump to 
code address. 


JZ code addr 

(PC) <- (PC) + 2 
IF (A) = 
THEN 


2 


1100000 
oooooooo 




If A is zero (0), then jump to 
code address. 


LCALL code aofdr 

(SP) «- (SP) + 1 
{(SP))^((PC))/ow 

(SP) <- (SP) + 1 
((SP)) ^ (PC) tiigtt 


2 


000 100 10 

1 1 1 1 1 1 1 If 

1 1 1 1 1 i 1 It 




Push PC on stack and 

IC^ICU>0 OIIUIO ValLIO VVIU 1 

code addr^. 


UMP cpcto addr 


2 


000000 10 

1 1 1 1 1 1 1 If 

II 1 1 1 1 lit 




Jump to code address. 


MOV fSiRr ^riata 

((Rr)) dafa 


1 


0111011r 

dddddddd 




IVILyVC II 1 M 1 lOUICIlC UCIlCt IXJ 

indirect address. 


MOV raRr A 
((Rr)) ^ (A) 


■\ 


1111011r 




MnuA A tn inrlirarA artHrocfi 

nnJW n lU lltUlfOm ClUUIOSK>> 


MOV (a)Rrf1ata addr 

((Rr)) <- (dara address) 


2 


1010011r 

mmmmmmmm 




address to indirect address. 


(A) «- dafa 


■) 


01 1 10100 

dddddddd 


p 


IVIUVO IMIIIitTUKXW Ucltel lU n. 


MOV A,@Rr 


1 


1 1 1 00 1 1 r 


P 


Move contents of Incftrect 

CtUUit^bo lU r\. 


MOV A,Rr 

fAt «- tW\ 


1 


1 1 1 1 r r r 


P 


Move register to A. 


MOV A,dafa addr 


1 


11100101 


P 


Move contents of data 


MOV C,b/f addr 

(0) ^ (b/f address) 


1 


10 100010 
bbbbbbbb 


C 


Move bit to C. 


MOV DPTR,#dafa 
(DPTR) «- data 


2 


100 10000 

ddddddddt 

ddddddddt 




Move two bytes of 
immediate data poir^. 


MOV Hr,#data 
(Rr) <- data 


1 


1 1 1 1 r r r 
dddddddd 




Move immediate data to 
register. 


MOV Rr,A 
(Rr)^(A) 


1 


1 1 1 1 1 r r r 




Move A to register. 


t The high order byte of the 1 6-bit operand is in the first byte fbHowing ttw opoode. The low order t>yte is In die 
second byte following the opcode. 
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Tatite B-1. Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 

Code 


Flags 
P OV AC C 


Function 


MOV Rr.data addr 

(Rr) «- (data address) 


2 


1 1 1 r r r 
mrnmmmmmm 




Move contents of data 
address to register. 


MOV bit addr.C 

(bit address) <- (0) 


2 


10 10010 
bbbbbbbb 




Move C to bit. 


MOV data addr,#data 
{data address) *- data 


2 


01110 10 1 

mmmmmmmm 
dddddddd 




Move immediate data to data 
address. 


MOV data addr,@\\r 

(data address) «- ((R# | 


2 


1 0000 1 1 r 

mmmmmmmm 




Move contents of indirect 

address to data address. 


MOV data addr A 

(data address) «- (A) 


1 


11110 10 1 
mmmmmmmm 




Move A to data address. 


MOV data addr,Rr i 
(data address) <- (Rr) 


2 


1 1 r r r 
mmmmmmmm 




Move register to data 
address. 


MOV data addrl.data addr2 
(data address 1) <- 
(data address2) 


2 


10 00101 

mmmmmmmm* 
mmmmmmmm* 




Move contents of second 
data address to first data 
address. 


MOVC A,@A + DPTR 

(PC) ^ (PC) + 1 
(A) ^ ((A) + (DPTR)) 


2 


10010011 


P 


Add A to DPTR and move 
contents of that axle 
address with A. 


MOVC A,@A + PC 
(A)«-((A) + (PC)) 


2 


1 000001 1 


P 


Add A to PC and move 
contents of that code 
address with A. 


MOVX @DPTR,A 
((DPTR)) ^ (A) 


2 


11110000 




Move A to external data 
location addressed by 
DPTR. 


MOVX @Rr,A 
((Rr)) <- (A) 


2 


1 1 1 1 1 r 




Move A to external data 
location addressed by 
register. 


MOVX A,@DPTR 
(A) <- ((DPTR)) 


2 


11100000 


P 


Move contents of external 
data location addressed by 
DPTR to A. 


MOVX A,@Rr 
(A) ^ ((Rr)) 


2 


IllOOOIr 


p 


Move contents of external 
data location addressed by 

register to A. 


MULAB 

(AB) ^ (A) * (B) 


4 


10 100100 


P OV C 


Multiply A by B 
(multiplication register). 


NOP 




00000000 




Do nothing. 


ORL A,#data 

(A) <- (A) OR dafa 




10 10 
dddddddd 


p 


Logical OR Immediate data 

to A. 


ORL A,@Rr 

(A) ^ (A) OR ((Br)) 




1 000 1 1 r 


p 


^'Ua; 

Logical OR contents of 

indirect address to A. 


ORL A,Rr 

(A) •«- (A) OR (Rr) 




1 1 r r r 


p 


Logical OR register to A. 


ORL A,dafa addr 

(A) «- (A) OR (data address) 




10 10 1 
mmmmmmmm 


p 


Logical OR contend of 
address to A. 


ORL C,b/f addr 

(C) ^ (C) OR (b/f address) 


2 


1110010 

bbbbbbbb 


C 


Logical OR bit to C. 


* The source data address (second data address) is encoded in the first byte following the opcode. The destination 
data address Is encoded in the second byte following the opcode. 
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Table B-1. Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


ORL C.lbit addr 

(C) *- (C) OR NOT {bit address) 


2 


10100000 
bbbbbbbb 


c 


Logical OR complement of 
bit to C. 


ORL data addr,#data 
{data address) <- 

{data address) OR data 


2 


10000 1 1 
mmnfinimrnnim 
dddddddd 




Logical OR Immediate data 
to data address. 


ORL data addr.A 

(data address) <— 

{data address) OR A 


1 


10 10 
mmmmmmmm 




Logical OR A to 
address. 


rUr data addr 

{data address) «- ((SP)) 
aSP) *- (SP) - 1 




1 1U1UUUU 

mmmmmmmm 




Place top of stack at data 
address and decrement SP. 


PUSH data addr 
(SP) <- (SP) + 1 
((or)) «— (cfata aaoress) 


2 


11000000 
mmmmmmmm 




Increment SP and place 
contents of data address at 
top of stack. 


RET 

(PC)/»/g/i ((SP)) 
(SP) «- (SP) - 1 
(PC)/oiv ((SP)) 
(SP) *- (SP) - 1 


2 


00100010 




Return from subroutine call. 


RETI 

(PC)n(gn «- ((SP)) 
(SP) ^ (SP) - 1 
(PC)/ow ^ ((SP)) 
(SP) «- (SP) - 1 


2 


00110010 




Return from intemjpt routine. 


RLA 


1 


10 11 




Rotate A left one position. 


PLC A 


1 


110 11 


P 


Rotate A through C left one 
position. 


HH A 


1 


000UU01 1 




Rotate A right one position. 


RRCA 


1 


000 100 1 1 


P c 


Rotate A through C right one 
position. 


SETB C 
(C) <- 1 


1 


110 10011 


c 


Set C to one (1). 


SETB bit addr 

(/Wf address} *— 1 


1 


1 10 10 10 
DDDDDDDD 




Set bit to one (1). 


SJMP code addr 

(PC) <- (PC) + 2 

(PC) «- (PC) + re/atfve.offisef 


2 


10000000 

00000000 




Jump to code address. 


Ql IRR A JtHata 
OUDD M,9FC7a(cf 

(A) «- (A) - (C) - data 


1 


1 nni n ^ an 

1 U U 1 U 1 u u 

dddddddd 


P r\\i AP C 


oUDiraci iiiiiiieuiaie uaia 
from A. 


SUBB A,(a Rr 

(A) ^ (A) - (C) - ((RA)) 


1 


1 1 1 1 r 


P OV AC C 


Subtract contents of indirect 
address from A. 


SUBB A,Rr 

(A) (A) - (C) - (Rf) 


1 


1 1 1 r r r 


P OV AC C 


Subtract register from A. 


SUBB A,dafa addr 

(A) *- (A) - (C) - (dafa address) 


1 


10010101 
mmmmmmmm 


P OV AC C 


Subtract contents of data 
address from A. 


SWAP A 


1 


11000 100 




Exchange low order nibble 
with high order nibble in A. 
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Table B-1. Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycies 


Binary 
Code 


Flags 
P OV AC C 


Function 


XCHA,@Rr ■ ■ >■■■ 
temp <— ((w)) ""'^ " 
((Rr)) ^ (A) 
(A) «- temp 


1 


1 1 1 1 r 


P 

) 


Move A to indirect addr^s 
and vice versa. 


XCH A,Rr 

femp «— (FV) 

m - (A) 

(A) «- temp 


1 


1 1 1 r r r 


P 

1 


Move A to register and vice 
versa. 


XCH A,da(a addr 

temp <- (dafa acldr«etB 
{data address) *- (fi^ 
(A) «- femp 


1 


110 00101 
ttirnrAfntnmmm 


P 


Move A to data address and 
vice versa. 

j 


XCHD A,@R/- 

femp «- ((Rr)) 0-3 

{{Br)) 0-3 «- (A) 0-3 

(A) 0-3 <- femp „ 


1 


1 1 1 1 1 r 


P ' 


Move low order of A to low 
order nibble of Indirect 
address and vice versa. 


XRL A,#data 

(A) ^ (A) XOR data 


1 


110 10 

dddddddd 


P 


Logical exclusive OR 
immediate data to A. 


XRL A,@Rr 

(A) ^ (A) XOR ((Rr)) 


1 


1 1 1 1 r 


P 


Logical exclusive OR 
contents of indirect address 
to A. 


XRL A,Ra 

(A) ^ (A) XOR (Rr) 


1 


1 1 1 r r r 


P 


Logical exclusive OR register 
to A. 


XRL A,dafa addr 

(A) *- (A) XOR (data address) 


1 


1100101 
mmmmmmmm 


P 


Logical exclusive OR 
contents of data address to 
A. 


XRL data addr,#data 
(data address) «- 

(dafa address) XOR data 


2 


1 1 0001 1 
mmmmmmmm 
dddddddd 




Logical exclusive OR 
Immediate data to data 
address. 


XRL dafa addr.A 
(dafa address) *- 

{data address) XOR A 


1 


1 10 10 
mmmmmmmm 




Logical exclusive OR A to 
data address. 



I 

I 
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Table B-2. Instruction Opcodes In Hexadecimal 



Hex 
Code 


Number 
of Bytes 


Mnamonic 

■ni I VII iwi 11 w 


Ooerands 


no 


1 


NOP 




M 
\J1 


o 


AJMP 


cods sdflF 


no 


o 


LJMP 


WW GhJWI 


no 




RR 


A 






INC 




OR 

uo 




INC 


LfOCa nUUf 


Oo 




IMP 

ii^o 








IMP 




Uo 




INC 


RO 


no 

U9 




INC 


R1 


UA 




IMP 

ll^w 


R2 


Uo 




IMP 

IINw 


RQ 


UO 




INC 


R4 


UU 




mo 


R5 


Ut 




IMP 


RR 


Ur 




IMP 


R7 


1U 


Q 
O 


IRP 


h/Y flWr/r r-nHtt Oflfir 


■4 4 
1 1 


o 


APAI 1 




1 o 

1£ 




1 PAI 1 


CfUuCf auUf 


1o 


4 

1 


OPP 


A 




4 
1 


npp 


A 


15 


4 
£. 


ncp 
ucu 


uaia aUUf 


lb 


4 

1 


npp 




1 / 


4 

1 


npp 




4 Q 


4 

1 


npp 


Rn 

nu 


18 


4 

1 


ncp 


n 1 


1 A 


4 

1 


npp 




ID 


4 

1 


npp 


R*^ 
no 


lO 


1 


npp 


R4 


1 n 
lU 


4 

1 


npp 


R(^ 
no 


It 


4 

1 


npp 


Rf^ 
no 


ir 


4 

1 


npp 


R7 
n / 


ZU 


q 
o 


IR 


/iff flWWr f^nfiet stfirir 


Z 1 


o 


A. IMP 






4 

1 


PPT 
nc 1 






4 
1 


Rl 


A 


Owl 


O 

<. 


Ann 


A J^Hata 
r\,iFUcHa 


OR 


o 


Ann 


M,Ucltcl aUUI 


oe 


4 

1 


Ann 


A rtT)nn 
Mjtct'nu 


07 


4 

1 


Ann 


A /7tiR1 
M,tu. n 1 


OO 


1 


Ann 


A RH 


OO 


4 
1 


Ann 


A R1 


OA 
£A 


4 

1 


Ann 


A R9 


on 


4 

1 


Ann 


A R^ 
M,no 


or* 
cO 


1 


Ann 


A RA 


on 


i 

1 


Ann 


A RCt 


oc 


4 

1 


Ann 


A RA 

A, no 


oc 


4 

1 


Ann 


A 07 


OA 

JU 




JiND 


bit 3ddr,codG sddr 


31 


2 


ACALL 


codeaddr 


32 


1 


RETI 




33 


1 


RLC 


A 


34 


2 


ADDC 


A,#dafa 


35 


2 


ADDC 


A,data ac/dr 


36 


t 


ADOC 


A,@RO 


37 


1 


ADDC 


A,@R1 


38 


1 


ADDC 


A,RO 


39 


1 


ADDC 


A,R1 


3A 


1 


ADDC 


A,R2 


3B 


1 


ADDC 


A,R3 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 
Code 



Number 
of Bytes 



Mnemonic 



Operands 



3C 
3D 
3E 
3F 
40 
41 
42 
43 
44 
4S 
46 
47 
48 
49 
4A 
4B 
4C 
40 
4E 
4F 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
5A 
SB 
5C 
5D 
5E 
5F 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
6A 
68 
6C 
60 
6E 
6F 
70 
71 
72 
73 
74 
75 
76 
77 



1 
1 
1 
1 
2 
2 
2 
3 
2 
2 
1 
1 
1 
1 
1 
1 

■^4 ■ .- 
1 

• 1 
2 
2 
2 
3 
2 
2 



ADDC 
ADDC 
ADDC 
ADDC 
JO 

AJMP 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

ORL 

JNC 

ACALL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

ANL 

JZ 

AJMP 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

XRL 

JNZ 

ACALL 

ORL 

JMP 

MOV 

MOV 

MOV 

MOV 



A,R4 
A,R5 
A,R7 
A,R7 

code addr 

code addr 

data ac/dr,A 

data addr,#data 

A,#data 

A,data addr 

A,@RO 

A,@R1 

A,RO 

A,R1 

A,R2 

A.R3 

A,R4 

A,R5 

A,R6 

A,R7 

code addr 

code addr 

data addr,fK 

data addr,#data 

k,#data 

A,data addr 

A,@RO 

A,@R1 

A,RO 

A,R1 

A,R2 

A,R3 

A,R4 

A,R5 

A,R6 

A,R7 

code addr 
code addr 
data addr.A 
data addr,#data 

A,*data 

A,data addr 

A,@RO 

A,@R1 

A,RO 

A,R1 

A,R2 

A.R3 

A,R4 

A,m 

A,R6 

A,R7 

code addr 
code addr 
C,bit addr 
@A + DPTR 
A,#date 

data addr,#data 

@RO,#da(a 

@R1,#data 
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Table Mh2. Instm^ion Opcodes in HsGade^al (Gonf d.) 



Hex 
Code 


Number 
of Bytes 


iViiipiiiiHiniG 




to 


o 


MOV 




TO 




IVIW V 


n 1 ,'iruciici 


TA 


o 

c. 


IVIW V 


Op JtHafa 


fO 





minx/ 


DO sHata 


TP 


o 


MOV 


RA dtHaffi 


fU 





MOV 


riQjTr Uata 


•rc 
f C 


o 


MOV 

IVIW V 


PR d^datfi 


/r 




MOV 

IVlw V 


R7 Mrlata 


OU 





9 IMP 


i/UuC dUUf 


fli 

Ol 


£. 


A IMP 


l/Uuc aUUl 


ao 
K£ 


o 


AMI 


P hi/ aririr 

W|Uf( ClUUf 


oo 


1 


MOX/P 




04 


H 

1 


niv 

UIV 


AR 


DO 


o 
O 


MOW 
IVIWV 


fioto AWWr WflfA of4fif 


OO 


o 


MOV 


Hata arlHr i^DH 


Of 


d. 


MOW 


Hafa ar4Hr fTv^Di 
uelfa aC/Cff ,<j5^n 1 


OQ 

Do 


o 


IVH^ V 


Uaia aUUf ,r\\J 


09 


o 


MOV 


Hafa ariHr PI 


OA 
On 


o 


MOV 

IVIW V 




OD 


o 

c. 


MOV/ 

IVIW V 




oO 



c. 


MOW 
IVIW V 


riata arlrir PA 


ou 


o 


MOV 

IVIW V 


ucicci auu/|r\9 


oc 


o 


IVIWV 


UalCI ciUUf iriv 


OP 


£ 


MOV 

IVIWV 


Hata afifir RT 
uaca ciuuf|n/ 


on 


o 


IVIWV 




0-1 


e. 


APAI 1 


CU09 SQOr 


QO 


o 


MOV 
IVIWV 


hit arlHr P 


90 


1 


IVIW VW 


A + DPTR 


OA 


O 
d. 


Ql IRR 


A Jtrlafa 


OC 

%lo 


o 
c. 


OUDD 


r\,Uala aUUf 


ao 




Ql IRR 
OUDD 




Q7 




c;i IRR 
oUDD 




90 




CI IRR 
OUDD 


A nn 


oo 

99 




OUDD 


A R1 

A,ri 1 


OA 
9A 


1 


Ql IRR 
OUDD 


A R9 


om 




CI IRR 
OUDD 


A R'% 


OP 
9Vy 




Ql IRR 


A RA 


on 

9U 




Ql iRR 
OUDD 


A DR 


oc 

9e: 




Ql IRR 
OUDD 


A PR 


OP 

9r 




Ql IRR 

OUDD 


A R7 


An 


o 


wnL 


P /hiY arlrlr 


Ai 


o 


A IMP 

rt J 1 VI r 


r*r\ri^ arirlf 


AO 


o 
& 


MW V 


P Hit ariHr 


A^a 


i|. 


IMP 


nPTR 
ur 1 n 


AA 


i r 


Ml II 


AR 
AD 


AR 

AO 




ras An 




Afi 
AO 


9 


MOW 


^v^DA Hata aHHr 


A7 

A# 


o 


MOW 
IVIL/V 


frtiDi Hata aHHr 


AO 

Ao 




IvHJV 


DA rif^tit nWWr 

nUjOara aaor 


A9 


2 


MOV 


B1,data addr 


AA 


2 


MOV 


R2,data addr 


AB 


2 


MOV 


R3,data addr 


AC 


2 


MOV 


R4,data addr 


AD 


2 


MOV 


R5,data addr 


AE 


2 


MOV 




AF 


2 


MOV 


H7,data addr 


BO 


2 


ANL 


CJbitaddr 


B1 


2 


ACALL 


code addr 


B2 


2 


CPL 


bit addr 


B3 


1 


CPL 


C 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 
Code 


Number 
of Bytes 


Mnemonic 


Operands 


B4 


3 


CJNE 


A,4Mata,cod0 addr 


B5 


3 


CJNE 


A,data addr.code addr 


Be 


3 


CJNE 


@RO,#data,code addr 


B7 


3 


CJNE 


@R^ ,'ff:data,code addr 


B8 


3 


CJNE 


RQ,#data,code addr 


B9 


3 


CJNE 


B^ ,#data,code addr 


BA 


3 


CJNE 


R2,#data,code addr 


BE 


3 


CJNE 


R3,#data,code addr 


BC 


3 


CJNE 


M,#data,code addr 


BD 




CJNE 


R5,#data,code addr 


BE 


9 


CJNE 


R6,4f^data,code addr 


BF 


3 


CJNE 


Rl ,#data,code addr 


CO 


2 


PUSH 


data addr 


C1 


2 


AJMP 


code addr 


C2 


2 


CLR 


bit addr 


C3 


1 


CLR 


C 


C4 


1 


SWAP 


A 


C5 




XCH 


A.dafa addr 


C6 


1 


XCH 


A,(5)R0 


C7 


1 


XCH 


A,@R1 


C8 


1 


XCH 


A,RO 


C9 




XCH 


A,R1 


CA 




XCH 


A,R2 


CB 




XCH 


A,R3 


cc 




XCH 


A,R4 


CD 




XCH 


A,R5 


CE 




XCH 


A,R6 


CF 




XCH 


A,R7 


DO 


2 


POP 


data addr 


D1 


2 


ACALL 


code addr 


D2 


S. 


SETB 


bit addr 


D3 


1 


SETB 


C 


D4 


1 


DA 


A 


D5 


3 


DJNZ 


(/afa addr,code addr 


D6 


1 


XCHD 


A,@RO 


D7 


1 


XCHD 


A,@R1 


D8 


2 


DJNZ 


RO,code addr 


D9 


2 


DJNZ 


R1 ,code addr 


DA 


2 


DJNZ 


R2,code addr 


DB 


2 


DJNZ 


R3,code addr 


DC 


2 


DJNZ 


R4,code addr 


DD 


2 


DJNZ 


R5,code addr 


DE 


s 


DJNZ 


R6,code addr 


DF 


2 


DJNZ 


P7,code addr 


EO 


1 


MOVX 


A,@DPTR 


El 


2 


AJMP 


code addr 


E2 


1 


MOVX 


A,@RO 


E3 


1 


MOVX 


A,@R1 


E4 


1 


CLR 


A 


E5 




MOV 


Kdata addr 






MOV 


A (a)RO 


E7 




MOV 


A,@R1 


E8 




MOV 


A,RO 


E9 




MOV 


A,R1 


EA 




MOV 


A,R2 


EB 




MOV 


A,R3 


EC 




MOV 


A,R4 


ED 




MOV 


A,R5 


EE 




MOV 


A.R6 


EF 




MOV 


A,R7 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



rwx 

CO<M 


Number 
of Bytss 


Mnemonic 


Operands 


FO 


1 


MOVX 


@DPTR,A 


F1 


2 


ACALL 


code addr 


F2 


1 


MOVX 


@RO,A 


F3 


1 


MOVX 


@R1,A 


F4 


1 


CPL 


A 


F5 




MOV 


data addr, A 


F6 




MOV 


@RO,A 


F7 




MOV 


@mA 


F8 




MOV 


RO,A 


Fg 




MOV 


R1,A 


FA 




MOV 


R2,A 


FB 




MOV 


R3,A 


FC 




MOV 


R4,A 


FD 




MOV 


R5,A 


FE 




MOV 


R6,A 


FF 




MOV 


R7,A 



1 

I 
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ABS, 5, 76, 113, 158, 181, 183 
Accumulator, 27, 106, 123, 146, 147, 193 
AMD, 5, 8, 74, 80, 118, 119, 181, 183 
ArBument Stack, 8, 31, 60, 61, 98, 106-108, 

112, 113, 118, 122, 123, 163, 165, 167, 

169 

Arithmetic Overflow, 97, 118 

Arithmetic Underflow, 97, 118 

Array Size, 99 

ASC, 83-85, 103, 158, 183 

Assembly Language Linkage, 29, 67, 99, 104 

ATN, 79, 114, 158, 181, 183 

Auto_Baucl, 2 

B 

BAUD Rate, 16, 24, 27, 28, 57, 89, 93, 94, 
131, 145-147, 158, 164, 169, 174, 175, 
178, 183, 189, 194 



CALL, 12, 29, 104, 107,1^4 130, 132, 158, 

178, 183 r ' 

Carry Bit, 27, 146 
CBY, 86, 114, 158, 182, 183 
CHR, 83, 85, 158, 183 
CLEAR, 6, 30, 32, 35, 66 158, 178 
CLEARI, 31, 32, 53, 178, 183 
CLEARS, 31, 178, 183 
CLOCKO, 32, 53, 158, 178, 183 
CL0CK1, 30-32, 52. 91, 92. 131. 158. 163, 

167, 178, 183 
Command Mode, 4, 12, 13, 24, 106, 109, 

111, 167, 191 
Command/Statement Extension, 10, 11, 122, 

153-159 
Constants, 5. 6, 122 
€XMT, 14, 38, 65, 158, 166, 176, 183 
Control Stack, 8, 1 1 , 31 , 42, 98, 169 
COS, 5, 77-79, 113, 158, 181, 183 
CR, 4. 55. 158 

D 

DATA, 33, 34, 97, 158, 178, 183 

Data Format, 5 

DBY, 86, 114, 158, 182, 183 



DIM, 6, 35, 99, 158, 167, 178, 113 
DIMUSE, 185, 186 
Direct Memory Access (DMA), 101, 

163,167 

DIVIDE, 5, 8, 80, 118, 119, 181, 183 
DO UNTIL, 8, 31, 36, 37, 98, 158,*l7i, 
DO WHILE, 8, 31, 37, 98, 158, 178, 183 
DPTR, 104, 106, 123. 147, 153, 155, 159. 1 
190, 193 ' "^ 

E 

END, 38, 158, 178, 183, 188 

EPROM Programming, 10, 20, 23, 72, 109, 

110, 132, 134-136, 141, 142, 162 
EQUAL, 7, 80, 81, 120, 158, 183 
Error Messages, 96-99 
EXCLUSIVE OR, 120, 158 
EXP, 78, 158, 181, 183 
EXPONENT, 74, 80, 119, 181, 183 
Expression, 6 



Floating Point Numbers, 55, 71, 107, 158. '-^ 

112, 118, 123, 184, 186 
FOR_TO_{STEP}_NEXT, 8, 11, 12, 31, 39 

40,42,98,158,178,183 ' '-^ 

FPROG, 25, 94, 158, 177, 183 
FPR0G1, 25, 177, 183 
FPR0G2, 25, 177, 183 
FPR0G3, 26, 177, 183 
FPR0G4, 26, 177, 183 
FPR0G5, 27, 177, 183 
FPR0G6, 27, 177, 183 
FREE, 7, 21, 95, 115. 158, 183 * 



GET, 67, 86, 87, 100, 115, 122, 123, 158, 

162, 165, 166, 169, 182, 183 
GOSUB, 8, 11, 12, 41, 43, 44, 51, 52, 61, 

98, 158, 179, 183 
GOTO, 12, 13, 43, 44, 46, 158, 179, 183 
GREATER THAN, 7, 80, 81, 121, 158, 183 
GREATER THAN OR EQUAL, 7, 80, 81, 
120, 158, 183 



ai3 
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I 

IDLE, 10, 69, 158, 167, 180, 183 

IE, 31, 51, 88, 101, 103, 116, 129, 130, 158, 

182, 183, 193, 198 
IF_THEN_ELSE, 9, 45, 46, 97, 158, 179, 

183 

Illegal Direct, 97 

INPUT, 47, 48, 82, 158, 179, 183 
Input Buffer, 11,111 
INT, 76, 113, 158, 181, 183 
Integers, 5, 75, 76 

INTELIigent Algorithm, 25, 26, 72, 109, 110. 

136. 141, 163, 165. 167, 169, 177 
Internal Stack, 8. 99 

Interrupts, 129, 130, 159, 160, 1S2, 163, 
166, 167 

IP, 88, 116, 158, 182. 183, 193. 198 

L 

LD@, 10, 71, 158, 180, 183 
LEN, 7, 95, 115, 158, 183 
LESS THAN, 7, 80, 81, 121, 158, 183 
LESS THAN OR EQUAL, 7, 80. 81. 120, 
158, 183 

LET, 49, 66, 82, 86, 91, 95, 158, 179, 183 
Line Editor, 8 

LIST. 4, 9. 10. 15-17. 21. 100, 158. 176, 
183 

LIST#, 16, 28, 94, 131, 176, 183 
LIST®, 11, 17, 59, 159, 166, 167, 176, 183 
LOG, 78, 114, 158, 181, 183 
LOGICAL AND. 76, 80, 81, 120, 158, 181, 
183 

LOGICAL EXCLUSIVE OR, 75, 80, 81, 181, 
183 

LOGICAL OR, 75, 80, 81, 120, 158, 181, 
183 

M 

MTOP, 2. 7, 21, 26, 27, 95, 115, 145, 152, 

158, 176, 183, 185, 187, 189, 191 
MULTIPLY, 8, 74, 80, 118, 119, 181, 183 

N 

NEGATION, 80, 158 
NEW, 18, 35, 66, 158, 176, 183 
NOT, 76, 81, 113, 158, 181, 183 
NOT EQUAL, 7, 80, 81, 121, 158, 183 
NULL, 19, 95, 15^, 1#6. 17% ISf »>g 

it X 



o 

ON GOSUB, 43, 44, 158, 179 
ON GOTO, 43, 44 158, 179 
ONERR. 30, 50, 158, 162, 166, 169, 179, 
183 

0NEX1, 30, 31, 51, 53, 64, 69, 129, 131, 
158, 162, 166, 169, 179, 183 

ONTIME, 30, 31, 51, 52, 53, 64, 69. 129, 
158,162,166,168,179.183 

ON_GOSUB, 183 

ONGOTO, 183 

Opbyte, 11, 106-1(ra, 111-124 

Operators. 122 

P 

PCON, 89, 117, 158, 182, 183, 193, 194 
PGM, 10, 72, 73, 104, 158, 180 183 

PHO., 58, 158, 179, 183 

PHO.#, 58, 179, 183 

PHO.@, 59, 180, 183 

PHI., 58, 157, 158, 179, 183 

PH1.#, 58, 179, 183 

PH1.@, 59, 180, 183 

PI, 77, 79, 115, 158, 182, 183 

POP, 60, 61, 98, 106, 108, 118, 130, 158, 

180, 183 
PORT1, 88, 117, 158, 182, 183 
PRINT, 4, 10, 11, 54, 55, 57-59, 63, 158, 

179, 183 

PRINT#, 28, 57, 94, 131, 179, 183 
PRINT@, 11. 59, 159, 166. 167. 180, 183 
PROG, 23. 25. 94, 131, 134, 158, 176, 183^ 
189 

PR0G1, 10, 24, 25, 145, 176, 183, 189 
PR0G2, 10, 24, 25, 145, 176, 183, 189 
PR0G3, 10, 26, 145, 176, 183, 189 
PROG4, 10, 26, 145, 176, 183 
PR0G5, 10, 27, 145, 177, 183 
PROG6, 10, 27, 146, 177, 183 
Programming Error, 98 
PSW, 130, 160, 193, 194 
PUSH, 60, 61, 98, 107, 130, 158, 180, 183 
PWM, 62, 90, 94, 131, 158, 170-173, 180, 
183 
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R 

RAM, 21, 158, 176, 183 

RAM Only Mode, 132 

RAM/EPROM Mode, 133, 134 

RCAP2, 89, 117, 158, 182, 183 

READ, 33, 34, 97, 158, 178, 183 

REM, 12, 63, 158, 180, 183 

Reset, 2, 3, 10, 24, 26, 27, 29, 102, 122, 

131, 145-152, 159, 176, 177, 191 
RESTORE, 33, 158, 178, 183 
RETI, 51, 53, 64, 158, 163, 180, 183 
RETURN, 41, 42, 64, 98, 123, 158, 179. 183 
RND, 77, 115, 158, 181, 183 
ROM, 21, 158, 176, 183 
RROM, 10, 70, 158, 180, 183 
RUN, 13, 21, 24, 35, 43, 100, 158, 176, 183 
Run Mode, 4, 13, 123 
Run Trap, 10, 27, 102, 169 

s 

SCON, 147, 190, 193, 197 . 
Serial Port, 131, 136, 159, 160,166 
SGN, 76, 113, 158, 181, 183 
Sign-On, 2 

StN, 5, 77-79, 114, 158, 181, 183 

SMOD, 194 

SPC, 4, 54, 158 

SQR, 77, 114, 158, 181, 183 

ST@, 10, 71, 158, 180, 183 
Stack Pointer, 8, 31, 105, 147, 152, 193 
STOP 14, 65, 98, 158, 163, 176, 180, 183 
STRING, 30, 49, 66, 82, 83, 99. 158, 164, 

168, 180, 183, 185 
•^iTRACT, 5, 8, 74, 8©^ I I***®!, 181, 183 



T 

T2C0N, 2, 3, 89, 116, 131, 147, 158, 182, 

183, 193 
TAB, 4, 54, 158 

TAN, 77, 79, 1 13, 158, 181 , 183 
TCON, 3, 90, 116, 131, 147, 158, 182, 183, 
193, 197 

Text Pointer, 122. 123, 162, 164, 166 
TIME, 7, 32, 52, 53, 91, 92, 116. 158. 182. 
183 

TIMERO. 90, 92, 116, 158, 182. 183 

TIMER1, 89, 90, 92, 94, 116, 158, 182, 183 
TIMER2, 89, 92, 94, 116, 158 174, 175, 182, 
183, 196 

TMOD, 3, 90, 117, 131, 147, 158, 182, 183, 

193, 195 

u 

Ul, 67, 158, 180, 183 
UNTIL, 178 
UO, 68, 158, 180, 183 
USING, 4. 55. 56. 112, 158 

V 

Variables, 6, 11, 122, 185 
VARTOP 185, 187 
VARUSE, 185-187 

X 

X-OFF, 10 
X-ON, 10 

XBY, 87, 114, 158, 182, 183 
XFER, 21, 22, 158, 176, 183 
XTAL, 2, 3, 7, 28, 32, 62, 89, 91, 93, 115, 
136, 152. 158. 165. 169, 174, 175, 183 
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